Signal-CLI-REST-API 中错误400问题的分析与解决

Signal-CLI-REST-API 是一个基于 Signal 协议的 RESTful API 服务，它允许开发者通过 HTTP 接口与 Signal 消息服务进行交互。近期，用户在使用过程中遇到了一个 HTTP 400 错误的问题，本文将详细分析该问题的原因及解决方案。

问题现象

当用户通过 Signal-CLI-REST-API 发送消息时，虽然消息能够成功发送，但系统会返回 HTTP 400 错误。这一现象在使用 Apprise 集成时尤为明显，Apprise 会持续报告该错误。通过直接调用 API 测试命令也能复现此问题。

根本原因

经过深入分析，发现这个问题实际上是 Signal-CLI 上游项目的一个已知问题。Signal-CLI 在处理某些消息发送请求时，会错误地返回 400 状态码，尽管消息实际上已经成功发送。

解决方案

Signal-CLI 项目团队已经在上游修复了这个问题。对于 Signal-CLI-REST-API 用户，可以采用以下两种解决方案：

1. 等待官方发布新版本：Signal-CLI 团队尚未发布包含此修复的正式版本。

2. 使用开发版本：可以暂时使用 bbernhard/signal-cli-rest-api:0.168-dev 这个开发版镜像，该版本已经包含了上游的修复补丁。

验证结果

测试表明，使用开发版本 bbernhard/signal-cli-rest-api:0.168-dev 后，消息发送不再返回 400 错误，问题得到完全解决。

最佳实践建议

对于生产环境，建议：

• 关注 Signal-CLI 的官方发布动态
• 在测试环境中验证新版本后再进行升级
• 保持对 API 响应状态的监控，即使消息看似发送成功

这个问题虽然不影响实际功能，但可能会干扰自动化系统的错误处理逻辑。开发者在集成 Signal-CLI-REST-API 时，应当注意处理这类"假阳性"错误。