Signal-CLI-REST-API 连接超时问题分析与解决方案

问题背景

在使用Signal-CLI-REST-API项目时，从0.82版本开始出现了无法搜索新号码或向新号码/群组发送消息的问题。主要表现为API调用时出现"Operation timed out"错误，返回400 Bad Request状态码。该问题在0.81及以下版本中不存在，表明可能是新版本引入的变更导致了连接问题。

问题表现

1. 搜索号码API返回超时错误：

{"error":"WARN RefreshRecipientsJob - Full CDSI recipients refresh failed...Operation timed out"}

2. 发送消息API返回未注册用户错误：

Failed to send (some) messages: [phone]: Unregistered user "[phone]"

3. 底层signal-cli日志显示网络连接超时：

org.signal.libsignal.net.NetworkException: connect timed out (IOException)

根本原因

经过深入分析，该问题主要由以下因素导致：

1. 网络连接超时：signal-cli在尝试连接Signal服务器时出现超时，可能是由于网络环境变化或服务器端调整了连接策略。

2. 代理配置问题：某些网络环境下需要配置代理才能正常连接Signal服务器，而默认配置可能无法正确处理代理设置。

3. 版本兼容性问题：从0.82版本开始，signal-cli内部使用的网络库可能进行了更新，导致在某些网络环境下的连接行为发生变化。

解决方案

临时解决方案

1. 回退到0.81版本：如果业务紧急，可以暂时使用0.81版本，该版本不受此问题影响。

2. 手动设置超时时间：虽然官方未提供直接配置超时时间的选项，但可以通过修改网络环境配置间接调整。

长期解决方案

1. 升级到最新开发版本：使用包含修复的0.181-dev或更新版本，这些版本集成了signal-cli 0.13.13+，修复了代理相关问题。

2. 配置网络代理：确保网络代理配置正确，特别是在企业网络环境下。

3. 设置用户资料：虽然不直接解决连接问题，但按照警告提示设置用户资料可以避免未来可能的问题：

   PUT /v1/profiles/{number}
   

最佳实践建议

1. 定期调用接收端点：在normal模式下，建议每小时调用一次/v1/receive端点以保持连接活跃。

2. 监控网络连接：使用tcpdump等工具监控网络流量，确认连接是否真正到达Signal服务器。

3. 启用调试模式：通过调试模式获取更详细的日志信息，帮助诊断问题：

   docker run -e DEBUG=1 ...
   

4. 保持版本更新：定期检查并更新到最新稳定版本，以获取问题修复和新功能。

结论

Signal-CLI-REST-API的连接超时问题主要源于网络连接和代理处理的变更。通过升级到包含修复的版本（0.181-dev或更新）并确保正确的网络配置，可以解决这一问题。对于关键业务系统，建议建立版本升级前的测试流程，以及时发现和解决兼容性问题。