Qinglong项目自定义通知JSON解析失败问题分析

在Qinglong 2.17.10版本中，用户在使用自定义通知功能时发现了一个影响JSON数据解析的bug。当用户尝试通过WEBHOOK_BODY环境变量传递包含JSON对象的通知内容时，系统会自动添加换行符，导致JSON解析失败。

问题本质

该问题的核心在于Qinglong的通知处理逻辑中，系统在处理自定义通知内容时，会在JSON数据中自动插入换行符(\n\n)。这些额外的换行符破坏了JSON格式的有效性，使得接收端无法正确解析JSON数据结构。

技术细节

从用户提供的截图可以看出：

1. 在sendNotify.js文件中，系统处理通知内容时可能对原始数据进行了不必要的格式化操作
2. 在notify.py文件中，接收到的JSON数据已经包含了破坏性的换行符

这种问题在Webhook集成场景中尤为常见，因为大多数Webhook接收端对JSON格式有严格要求，任何非预期的字符都会导致解析失败。

解决方案

开发者whyour在2.17.11版本中修复了这个问题。修复方案可能包括以下一种或多种措施：

1. 移除了自动添加换行符的逻辑
2. 在JSON序列化前对数据进行适当的转义处理
3. 确保通知内容在传输过程中保持原始格式不变

最佳实践建议

对于使用Qinglong自定义通知功能的用户，建议：

1. 及时升级到2.17.11或更高版本
2. 在定义JSON格式的通知内容时，确保遵循标准的JSON格式规范
3. 对于复杂的JSON结构，可以先在JSON验证工具中测试有效性
4. 在升级后如仍遇到类似问题，可考虑手动对JSON中的特殊字符进行转义处理

这个修复体现了Qinglong项目对用户体验的持续关注，也展示了开源项目快速响应和解决问题的能力。