Domoticz项目SMTP邮件发送问题分析与解决方案

问题背景

近期部分Domoticz用户报告使用SMTP协议发送邮件时出现异常，邮件服务器返回错误代码"552 5.2.0 Message contains bare LF and is violating 822.bis section 2.3"。该问题主要出现在使用Ziggo等严格遵循RFC标准的邮件服务商环境中。

技术分析

SMTP协议(RFC 5321)明确规定邮件消息体中的行终止符必须使用CRLF(回车换行)序列。然而在Domoticz的实现中，HTML邮件正文部分使用了仅LF(换行)的格式，这违反了协议规范。

通过调试发现，问题根源在于：

1. HTML邮件正文生成时使用了单LF换行符
2. 邮件服务器近期加强了对RFC标准的合规性检查
3. 这种不规范格式可能导致潜在的邮件安全问题(CVE-2023-51764等)

解决方案

Domoticz开发团队迅速响应，在代码层面进行了以下修复：

1. 在SMTPClient.cpp文件中增加了行终止符规范化处理
2. 对HTML正文内容执行LF到CRLF的强制转换
3. 确保所有邮件内容部分都符合RFC标准

核心修复代码如下：

stdreplace(m_HTMLBody, "\r\n", "\n");
stdreplace(m_HTMLBody, "\n", "\r\n");

影响范围

该修复已包含在Domoticz 2024.2 beta 15866及后续版本中。受影响的用户包括：

• 使用严格遵循RFC标准的SMTP服务器
• 发送HTML格式邮件的场景
• 近期邮件服务器升级了合规性检查的环境

最佳实践建议

1. 建议所有用户升级到包含此修复的版本
2. 对于无法立即升级的用户，可考虑以下临时方案：
   • 使用本地邮件中继服务
   • 配置宽松的SMTP服务器作为中间件
3. 开发邮件相关功能时应严格遵循RFC标准
4. 注意监控邮件服务器的协议合规性要求变化

总结

Domoticz团队对SMTP协议合规性的及时修复，不仅解决了当前邮件发送问题，也提升了系统的安全性和稳定性。这体现了开源项目对标准遵循和用户体验的重视，值得开发者借鉴。