Apache DolphinScheduler V3.3.2 单机部署告警邮件JSON解析异常分析

问题背景

在Apache DolphinScheduler V3.3.2版本的单机部署环境中，用户配置了告警功能并成功发送了测试邮件，但在实际工作流执行完成后发送告警邮件时，系统却抛出了JSON解析异常。这个问题的出现表明系统在处理告警插件参数时存在类型不匹配的情况。

错误现象

系统日志中显示的错误信息如下：

[ERROR] 2025-02-15 00:19:28.869 +0800 o.a.d.c.u.JSONUtils:[186] - parse list exception!
com.fasterxml.jackson.databind.exc.MismatchedInputException: 
Cannot deserialize value of type `java.util.ArrayList<org.apache.dolphinscheduler.spi.params.base.PluginParams>` 
from Object value (token `JsonToken.START_OBJECT`)

问题分析

这个错误的核心在于Jackson库在尝试反序列化JSON数据时遇到了类型不匹配的问题。具体表现为：

1. 系统期望将JSON数据反序列化为一个ArrayList<PluginParams>类型的集合
2. 但实际接收到的JSON数据却是一个对象（由JsonToken.START_OBJECT标记指示）
3. 这种类型不匹配导致了反序列化失败

在DolphinScheduler的架构中，告警插件参数通常以列表形式存储和传递。当系统尝试从数据库中读取这些参数配置时，如果存储格式与预期不符，就会出现此类解析错误。

解决方案

根据项目成员的回复，此问题已在dev分支中得到修复。对于遇到此问题的用户，可以考虑以下解决方案：

1. 升级版本：等待包含此修复的正式版本发布后升级到新版本
2. 手动修复：如果熟悉代码，可以检查告警插件参数的存储和读取逻辑，确保：
   • 参数以正确的JSON数组格式存储
   • 反序列化时使用正确的类型信息
3. 临时规避：重新配置告警设置，确保参数以列表形式保存

技术细节

这个问题涉及到DolphinScheduler的几个核心组件：

1. 告警模块：负责工作流执行状态的监控和通知
2. 插件系统：使用SPI机制管理各种告警插件
3. 参数序列化：使用Jackson库处理插件参数的JSON序列化/反序列化

在正常情况下，告警插件的参数应该以JSON数组形式存储，例如：

[
  {"field":"recipients","value":"[e-mail]"},
  {"field":"subject","value":"Workflow Alert"}
]

但如果存储为单个对象而非数组，就会导致上述解析错误：

{"field":"recipients","value":"[e-mail]"}

总结

这个JSON解析异常揭示了DolphinScheduler在告警模块参数处理上的一个边界情况问题。虽然测试邮件可以正常发送，但在实际工作流执行时的参数处理流程可能存在差异。开发团队已经注意到这个问题并在开发分支中进行了修复，建议用户关注后续版本更新以获取稳定的解决方案。