Signal-CLI-REST-API JSON-RPC模式消息接收问题分析与解决方案

Signal-CLI-REST-API是一个基于Signal协议的REST API服务，允许开发者通过HTTP接口与Signal消息系统交互。近期在0.86版本中，用户报告了一个关于JSON-RPC模式下消息接收异常的问题，本文将深入分析该问题的成因及解决方案。

问题现象

在0.85版本中，用户通过WebSocket连接（ws://host:8080/v1/receive/）能够正常接收消息，同时通过HTTP接口（/v2/send）发送消息也工作良好。然而升级到0.86版本后，出现了以下异常情况：

1. 消息发送功能保持正常
2. 消息接收功能在短暂工作后停止响应
3. 无明显的错误日志输出
4. 问题在Node-RED和wscat工具中均能复现

技术分析

从开发者提供的调试日志中，我们可以观察到关键错误信息：

"Couldn't send message to golang channel, as there's no receiver"

这表明消息处理管道中出现了通道阻塞或消费者丢失的情况。具体表现为：

1. Signal服务接收到了消息（在Signal客户端显示已送达）
2. 消息被正确解析为JSON-RPC格式
3. 消息成功进入Golang通道
4. 但通道的另一端没有接收者处理这些消息

根本原因

经过开发者调查，这个问题源于0.86版本中的消息通道处理逻辑存在缺陷。当WebSocket连接因各种原因（网络波动、客户端重启等）断开时，系统未能正确重建消息消费管道，导致后续消息无法被传递。

解决方案

开发者提供了两个临时修复版本：

1. 0.165-dev版本：初步修复了通道处理逻辑
2. 0.166-dev版本：进一步完善了消息管道稳定性

用户反馈表明0.166-dev版本解决了问题，包括：

• 长时间运行稳定性
• 消息接收的可靠性
• 各种客户端工具(Node-RED、wscat)的兼容性

最佳实践建议

对于使用Signal-CLI-REST-API JSON-RPC模式的开发者，建议：

1. 升级到最新稳定版本（0.88及以上）
2. 实现客户端重连机制，处理可能的连接中断
3. 在生产环境启用调试日志以便快速定位问题

   curl -X POST -H "Content-Type: application/json" -d '{"logging": {"level": "debug"}}' 'http://127.0.0.1:8080/v1/configuration'
   

4. 监控消息处理管道状态，及时发现异常

总结

Signal-CLI-REST-API作为Signal协议的重要桥梁，其稳定性对业务系统至关重要。本次JSON-RPC模式的消息接收问题通过开发者社区的快速响应得到了有效解决，展现了开源协作的优势。建议用户保持对项目更新的关注，及时应用修复版本以确保系统稳定运行。