Signal-CLI 中 Invalid Signature 错误的解决方案

Signal-CLI 是一款基于命令行的 Signal 消息服务客户端工具。近期部分用户在使用过程中遇到了 "Invalid signature" (422 错误) 的问题，本文将深入分析该问题的成因并提供完整的解决方案。

问题背景

当用户尝试使用 Signal-CLI 发送消息或执行其他操作时，系统返回 422 错误，提示 "Invalid signature"。该问题主要影响较长时间未使用的账户或某些特定版本的 Signal-CLI。

问题根源

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

1. PNI 身份密钥缺失：Signal 服务引入了 PNI (Phone Number Identity) 密钥机制，部分旧账户在服务端缺少必要的 PNI 身份密钥记录。

2. 过渡期兼容性问题：Signal 曾有一个过渡期，允许客户端上传 PNI 密钥与新预密钥。未在此期间使用兼容版本的 Signal-CLI 的账户会出现此问题。

3. 签名验证失败：当客户端尝试更新预密钥时，由于服务端缺少必要的 PNI 身份密钥记录，导致签名验证失败。

解决方案

方法一：重新注册账户（需要短信验证）

1. 首先执行取消注册命令：

   signal-cli -u +电话号码 unregister
   

2. 然后重新注册：

   signal-cli -u +电话号码 register
   

3. 最后进行验证：

   signal-cli -u +电话号码 verify 验证码
   

方法二：使用恢复密码重新注册（无需短信验证）

此方法需要账户已设置 PIN 码：

1. 设置或确认 PIN 码：

   signal-cli -u +电话号码 setPin PIN码
   

2. 重新注册：

   signal-cli -u +电话号码 register
   

方法三：强制重新注册

1. 修改账户配置文件中的 "password" 字段（通常位于 ~/.local/share/signal-cli/data/账户文件/accounts.json）

2. 然后执行注册命令：

   signal-cli -u +电话号码 register
   

技术细节

Signal-CLI 在 0.13.1 及以上版本中已优化了相关处理逻辑：

1. 当检测到 PNI 密钥问题时，会尝试自动修复
2. 增强了 setPin 命令的健壮性
3. 改进了重新注册流程的错误处理

最佳实践

1. 定期使用 Signal-CLI 保持账户活跃
2. 为所有 Signal 账户设置 PIN 码
3. 保持 Signal-CLI 版本更新
4. 对于重要账户，定期备份配置文件

总结

Signal-CLI 的 "Invalid signature" 错误主要是由于服务端与客户端在 PNI 身份密钥方面的不一致导致的。通过重新注册或使用恢复密码机制，用户可以解决此问题并恢复账户功能。随着 Signal-CLI 的持续更新，这类兼容性问题将得到更好的处理。