Core Lightning 中 sendcustommsg 参数错误问题分析

问题现象

近期在 Core Lightning 项目中，部分用户节点日志中频繁出现类似错误信息："JSON COMMAND sendcustommsg: Invalid parameter node_id (should be a node id): token '""'"。该错误大约每2-4分钟就会出现一次，且通常伴随着"Unknown channel"的警告信息。

错误特征

从日志分析可以看出，该错误具有以下典型特征：

1. 错误信息明确指出是 sendcustommsg 命令的参数验证失败
2. node_id 参数被传递了空字符串("")而非有效的节点ID
3. 错误往往与通道异常情况相关联
4. 时间上通常出现在通道相关警告后的10秒左右

问题根源

经过深入排查，发现问题源于 Core Lightning 与第三方插件 Peerswap 的兼容性问题。Peerswap 插件在尝试发送自定义消息时，未能正确处理节点ID参数，导致传递了空值。

技术背景

在 Lightning Network 协议中，sendcustommsg 是一个重要的底层命令，用于节点间发送自定义协议消息。该命令严格要求有效的节点ID作为参数，用于标识消息接收方。当参数验证失败时，系统会记录错误日志以防止潜在的安全问题。

解决方案

Peerswap 开发团队已经针对此问题发布了修复补丁，主要改进包括：

1. 完善了节点ID参数的验证逻辑
2. 确保在所有情况下都能获取有效的节点ID
3. 增加了错误处理机制，避免无效参数传递

最佳实践建议

对于运行 Core Lightning 节点的用户，建议：

1. 定期检查节点日志中的异常信息
2. 保持插件与核心软件的版本同步
3. 遇到类似问题时，首先检查相关插件的更新情况
4. 对于生产环境，建议在测试环境验证新版本后再进行升级

总结

这次事件展示了 Lightning Network 生态系统中组件间交互的重要性。随着协议的不断演进，开发者需要特别注意API变更和参数验证的严格性。同时，也体现了开源社区快速响应和修复问题的能力。