Spring Boot 应用在 ECS 中启动时触发 MailHealthIndicator 警告，核心原因为 SMTP HELO 命令格式不合法（501 Syntax: HELO <hostname>），同时需警惕 SES 账户因高退信/投诉率导致的邮件健康状态异常。
spring boot 应用在 ecs 中启动时触发 `mailhealthindicator` 警告，核心原因为 smtp helo 命令格式不合法（`501 syntax: helo
该警告看似是 Spring Boot 健康检查的网络层问题，实则暴露两个层面的关键风险：SMTP 协议交互缺陷与SES 发送信誉健康度隐患。二者需协同排查，缺一不可。
? 一、HELO 语法错误：根源在 JVM 主机名解析
日志中明确指出错误：501 Syntax: HELO <hostname> —— 这是标准 SMTP 协议要求客户端在建立连接后必须发送合法 HELO 或 EHLO 命令，且参数必须为有效的 DNS 可解析主机名（如 example.com），不能是空字符串、IP 地址或非法格式（如 localhost、127.0.0.1、无域名的短名称）。
在 Docker + ECS 环境中，问题通常源于：
- JVM 启动时通过 InetAddress.getLocalHost().getHostName() 获取主机名；
- 容器内 /etc/hosts 未正确配置，或容器网络模式（如 awsvpc）下 hostname 解析为空或为随机 ID（如 ip-10-0-1-123）；
- Spring Boot 默认未显式配置 SMTP ehlo 主机名，依赖底层 JavaMail 自动推导。
✅ 解决方案（推荐）：
在 application.yml 中强制指定 mail.smtp.localhost 参数，覆盖默认行为：
spring:
mail:
host: email-smtp.us-east-1.amazonaws.com # 替换为你的区域端点
port: 587
username: ${SES_SMTP_USERNAME}
password: ${SES_SMTP_PASSWORD}
properties:
mail.smtp.auth: true
mail.smtp.starttls.enable: true
mail.smtp.starttls.required: true
# ? 关键修复：显式声明合法 HELO 域名
mail.smtp.localhost: ses-health-check.example.com # 使用任意可解析域名（无需真实存在，但需符合DNS格式）⚠️ 注意：该域名无需真实注册或解析，仅需满足 RFC 5321 规范（字母、数字、连字符、点号组成，以字母开头，不以点结尾）。避免使用 localhost、127.0.0.1 或纯数字字符串。
若使用 JavaMail API 手动构建 Session，等效代码为：
Properties props = new Properties();
props.put("mail.smtp.localhost", "ses-health-check.example.com");
Session session = Session.getInstance(props);? 二、SES 邮件健康状态：不可忽视的隐性风险
MailHealthIndicator 的本质是模拟一次轻量级 SMTP 连接测试（类似 telnet + HELO + QUIT）。即使 HELO 修复后警告消失，若 SES 账户处于“不健康”状态，实际发信仍会失败。
AWS SES 会持续监控两项核心指标： | 指标 | 定义 | 安全阈值 | 风险后果 | |------|------|----------|----------| | 硬退信率（Hard Bounce Rate） | 收件方服务器永久拒绝（如邮箱不存在、域名无效） | ≤ 5%（沙箱） / ≤ 0.1%（生产） | 账户暂停发送、配额冻结 | | 投诉率（Complaint Rate） | 收件人点击“标记为垃圾邮件” | ≤ 0.1%（沙箱 & 生产） | 立即限制发送、触发人工审核 |
? 快速自查路径（控制台）：
- 进入 SES 控制台 → Email Sending → Sending Statistics
- 查看 Bounces 和 Complaints 曲线，确认 24 小时内比率是否超标
- 若已超限，立即停止批量发送，检查收件列表是否含：
- 已失效邮箱（如离职员工、注销账户）
- 购买/爬取的未经许可邮箱（高风险 spam trap）
- 缺少退订链接或发信频率过高的营销邮件
✅ 长期健康建议：
- 启用 SES 配置集（Configuration Set），集成 SNS 实时接收 Bounce/Complaint 事件并自动清理黑名单；
- 对新邮箱列表执行 SES Mailbox Simulator 预检；
- 生产环境务必申请 SES 生产访问权限，脱离沙箱限制。
✅ 总结：双轨排查清单
| 步骤 | 操作 | 验证方式 |
|---|---|---|
| 1. 修复 HELO | 在 application.yml 添加 mail.smtp.localhost 配置 | 重启应用，确认 CloudWatch 不再出现 501 Syntax 日志 |
| 2. 验证连接 | 手动执行 telnet email-smtp.{region}.amazonaws.com 587 → 输入 HELO ses-health-check.example.com → 应返回 250 | 排除网络/NACL/安全组拦截 |
| 3. 检查信誉 | 查看 SES 控制台 Sending Statistics 中 Bounce/Complaint 率 | 若 >0.1%，立即暂停发送并清理收件列表 |
| 4. 沙箱验证 | 确保所有收件地址已在 SES 中验证（沙箱强制要求） | send_email API 返回 Email address not verified 即未验证 |
? 提示：Spring Boot 的 MailHealthIndicator 仅用于探活，不校验 SES 账户健康度。真正的发信能力取决于 SES 后端策略——因此，修复 HELO 后务必同步审计发信质量，否则应用“健康”而业务“失能”。
