Signal-CLI 中 InvalidKeyId 异常的分析与解决方案

异常现象描述

在使用 Signal-CLI 0.13.12 版本的 JSON-RPC 模式时，部分设备会出现 InvalidKeyIdException 异常，错误信息显示为"No such signed pre key record: 607855"。值得注意的是，该问题并非在所有设备上都会出现，测试的8台设备中有5台工作正常。

异常技术背景

该异常属于 Signal 协议层的密钥验证问题，具体表现为客户端无法找到对应的签名预密钥记录。Signal 协议使用预密钥机制来实现异步消息传递，每个客户端都会生成一组预密钥并上传到服务器。当发送方要给接收方发送消息时，会从服务器获取接收方的一个预密钥来建立加密会话。

问题根源分析

根据技术讨论和日志分析，问题可能由以下几种情况导致：

1. 密钥存储不一致：服务器上注册的预密钥与本地存储的预密钥不匹配
2. 密钥同步问题：在注册或重新注册过程中，预密钥生成和上传流程出现异常
3. 多设备冲突：当主设备和链接设备同时操作时可能出现密钥状态不一致

日志中显示在重新注册后，预密钥ID从607855变为607858，但客户端仍在尝试使用旧的密钥ID进行解密，这表明存在密钥状态不同步的问题。

解决方案

1. 升级到最新版本：Signal-CLI 0.13.14 版本已包含针对无效消息处理的改进，可以解决此问题

2. 完整的重新注册流程：

   • 完全删除旧账户数据
   • 执行全新注册
   • 确保预密钥生成和上传过程完整完成

3. 环境一致性检查：

   • 确保所有使用同一账户的设备运行相同版本的Signal-CLI
   • 检查Java运行环境版本是否一致

技术细节补充

Signal协议使用三种类型的密钥：

• 身份密钥(Identity Key)：长期存在的密钥对
• 签名预密钥(Signed Pre Key)：中期密钥，定期轮换
• 一次性预密钥(One-time Pre Key)：短期使用的密钥

当出现InvalidKeyIdException时，说明客户端无法找到对应的签名预密钥记录，这会导致会话初始化或消息解密失败。Signal-CLI 0.13.14版本对此类情况做了更健壮的处理，包括自动请求会话更新等机制。

最佳实践建议

1. 定期更新Signal-CLI到最新版本
2. 避免在多台设备上使用相同的账号同时操作
3. 出现密钥相关错误时，优先考虑完全重新注册而非部分修复
4. 监控预密钥数量，确保始终保持足够的预密钥储备

通过以上分析和解决方案，开发者可以更好地理解和处理Signal-CLI中的密钥验证异常问题，确保消息传输的安全性和可靠性。