Signal-Cli-REST-API 中 EOF 错误分析与解决方案

Signal-Cli-REST-API 是一个基于 Signal 协议的 RESTful API 服务，它通过 signal-cli 命令行工具为开发者提供了与 Signal 消息服务交互的能力。在实际使用过程中，用户可能会遇到一个特定的错误："Couldn't read data for number : EOF. Is the number properly registered?"。本文将深入分析这一问题的成因及解决方案。

问题现象

当用户使用 JSON-RPC 模式运行 Signal-Cli-REST-API 时，系统日志中会周期性出现 EOF 错误信息，同时 API 调用会返回"broken pipe"错误。虽然重启服务可以暂时解决问题，但错误会随机重现。

根本原因分析

经过深入调查，发现该问题可能由以下几个因素导致：

1. 多账户配置问题：JSON-RPC 模式会尝试连接所有已注册号码或链接设备。如果存在不再使用的旧注册信息，系统会持续尝试连接这些无效端点。

2. 资源限制：在资源受限的环境中（如内存不足的虚拟机），Signal 服务可能无法维持稳定的连接。

3. 配置自动恢复：手动修改配置文件后，系统会自动将其恢复为默认值，这表明存在配置管理机制在干预。

解决方案

1. 清理并重新注册信号号码

最彻底的解决方案是清理旧的注册信息并重新注册：

1. 备份 signal-cli-config/data 目录内容
2. 删除该目录下的所有文件
3. 通过 API 重新注册或链接您的号码

2. 检查并优化系统资源

对于运行在虚拟机或资源受限环境中的实例：

1. 增加分配给虚拟机的 CPU 核心数
2. 扩大内存分配（建议至少增加50%）
3. 监控系统资源使用情况，确保没有其他服务占用过多资源

3. 验证配置完整性

检查配置文件中的关键项：

config:
  <multi-account>:
    tcp_port: 6001
    fifo_pathname: /tmp/sigsocket1

确保配置项正确且未被自动修改。如果发现配置被自动恢复，可能需要检查是否有其他进程在管理这些文件。

预防措施

1. 定期维护：定期检查 signal-cli-config/data 目录，清理不再使用的注册信息。

2. 资源监控：设置系统监控，确保 Signal-Cli-REST-API 有足够的资源运行。

3. 版本管理：在升级前，充分测试新版本在您的环境中的稳定性。

结论

EOF 错误通常表明连接被意外终止，在 Signal-Cli-REST-API 的上下文中，这往往与注册状态异常或系统资源不足有关。通过清理旧注册信息和优化系统环境，大多数用户都能解决这一问题。如果问题持续存在，建议考虑切换到非 RPC 模式作为临时解决方案，同时继续排查根本原因。