Jellyseerr Webhook通知中Unicode字符处理问题解析

在Jellyseerr媒体请求管理系统中，开发团队发现了一个与Webhook通知功能相关的重要问题。当用户在Webhook通知内容中使用Unicode字符（如表情符号）时，系统会抛出JSON解析错误，导致通知发送失败。

问题现象

用户反馈，在创建通用Webhook通知时，如果在消息体中包含表情符号等Unicode字符（例如"🚀"），点击测试按钮后系统会在日志中记录如下错误信息：

Unexpected token \u001f in JSON at position 77

这个问题会完全阻断包含Unicode字符的通知发送功能，影响用户体验。

技术分析

经过代码审查，发现问题根源在于系统对Webhook消息体的编码处理方式。在Jellyseerr的Webhook通知模块中，存在两处关键代码将消息内容强制转换为ASCII编码：

1. Webhook代理实现中，消息体被显式转换为ASCII字符串
2. 通知设置路由中，同样使用了ASCII编码处理

ASCII编码仅支持基本的英文字符和符号，无法正确表示Unicode字符（如表情符号、非拉丁字母等）。当系统尝试将包含Unicode字符的消息转换为ASCII时，会导致数据损坏，进而引发JSON解析错误。

解决方案

正确的做法是将编码方式从ASCII改为UTF-8。UTF-8编码完全兼容ASCII，同时支持所有Unicode字符，是处理多语言文本的国际标准。具体修改包括：

1. 将Webhook代理中的编码转换从ASCII改为UTF-8
2. 同步更新通知设置路由中的编码处理方式

这种修改不仅解决了表情符号的问题，还使系统能够支持各种语言的文字内容，提高了国际化支持能力。

影响评估

该修改属于正向改进，不会引入兼容性问题，因为：

1. UTF-8完全向下兼容ASCII，纯英文内容处理方式不变
2. JSON规范本身要求使用UTF-8编码
3. 现代Web服务普遍支持UTF-8编码

此问题已在Jellyseerr 1.9.0版本中得到修复，用户升级后即可正常使用包含Unicode字符的Webhook通知功能。

最佳实践建议

对于开发者处理类似文本编码问题时，建议：

1. 始终优先考虑使用UTF-8编码处理文本
2. 在API设计中明确指定编码方式
3. 对用户输入内容进行适当的编码验证
4. 在日志记录中保留原始编码信息以便调试

通过这次问题的解决，Jellyseerr的Webhook通知功能变得更加健壮和国际化，能够更好地满足全球用户的需求。