Signal-CLI 附件发送失败问题分析与解决方案

Signal-CLI 作为 Signal 消息服务的命令行客户端，近期部分用户反馈在发送图片附件时出现 404 错误。本文将从技术角度分析问题原因并提供完整的解决方案。

问题现象

用户在使用 Signal-CLI 发送消息时发现：

• 纯文本消息发送正常
• 附加图片时返回 404 Not Found 错误
• 错误信息中包含"uploadAttachmentV2"等关键词

根本原因分析

经过技术排查，该问题主要由以下两个因素共同导致：

1. Signal 服务端废弃旧版附件接口
   Signal 官方近期移除了旧版 V2 附件上传接口，强制要求客户端使用新版接口。这是服务端的一次重大变更。

2. 客户端版本兼容性问题
   Signal-CLI 0.13.5 之前版本仍依赖已被移除的 V2 接口，导致附件上传失败。新版客户端(0.13.5+)已完全迁移至新接口。

解决方案

方案一：升级 Signal-CLI 客户端

推荐将 Signal-CLI 升级至 0.13.5 或更高版本：

# 检查当前版本
signal-cli --version

# 升级到最新版
sudo apt update && sudo apt upgrade signal-cli

方案二：重新注册账号

如果升级后问题仍然存在，可尝试重新注册账号：

# 先注销账号
signal-cli unregister <手机号>

# 重新注册
signal-cli register <手机号>

方案三：系统环境检查

部分用户可能需要检查系统环境：

1. 确保 Java 版本 ≥ 17（推荐 21）
2. 检查 GLIBC 版本（Debian 12 等新系统更可靠）
3. 验证 DBus 服务正常运行

技术细节补充

Signal 服务端的这次变更反映了其技术架构的演进：

• 新版附件接口采用更高效的传输协议
• 支持更大的文件尺寸限制
• 提供更好的错误处理和重试机制

对于开发者而言，这提醒我们需要：

• 及时关注服务端 API 变更公告
• 保持客户端版本更新
• 实现完善的错误处理逻辑

总结

Signal-CLI 附件发送问题本质上是服务端接口变更导致的兼容性问题。通过升级客户端版本或重新注册账号即可解决。这也提醒我们，在使用开源通信工具时，保持软件更新是确保功能正常的关键。

建议用户定期检查 Signal-CLI 的版本更新，并关注项目的官方公告，以获取最新的功能改进和兼容性信息。