Jenkins邮件配置后无法发送测试邮件

Question

Jenkins配置邮件通知后无法发送测试邮件，常见原因之一是SMTP服务器认证失败。即使邮箱账号、密码及SMTP地址填写正确，若未启用“使用SSL”或“使用TLS”选项（取决于邮件服务商要求），连接将被拒绝。此外，部分邮箱服务（如QQ、163）需开启SMTP权限并使用授权码而非登录密码。Jenkins日志常提示超时或认证错误，需检查系统管理员邮件地址格式是否与发件人一致，并确保未被防火墙拦截。

Answer 1

一、Jenkins邮件通知配置失败的常见现象与初步排查

在持续集成环境中，Jenkins通过邮件通知功能向开发和运维团队发送构建状态至关重要。然而，许多用户在配置完成后尝试发送测试邮件时遭遇失败。最典型的错误表现为：“Failed to send test email”，伴随日志中出现 javax.mail.AuthenticationFailedException 或 Connection timed out 等异常。

• SMTP服务器地址填写错误（如 smtp.qq.com 写成 smtp.q.com）
• 端口号不匹配：SSL通常使用465，TLS使用587
• 未启用加密协议（SSL/TLS），导致连接被远程服务器拒绝
• 系统管理员邮箱格式不合法或与发件人地址不一致

这些问题虽看似基础，但在实际部署中频繁发生，尤其在跨网络环境或企业防火墙策略严格的情况下更为突出。

二、深入分析SMTP认证机制与加密协议要求

邮件服务商	SMTP服务器	端口（SSL）	端口（TLS）	是否需授权码
QQ邮箱	smtp.qq.com	465	587	是
163邮箱	smtp.163.com	465	25/587	是
Gmail	smtp.gmail.com	465	587	是（应用专用密码）
Outlook/Hotmail	smtp-mail.outlook.com	—	587	否（现代OAuth）

从上表可见，不同服务商对安全传输层的要求存在差异。例如QQ邮箱必须启用SSL并使用465端口，同时登录凭证应为“授权码”而非账户登录密码。若在Jenkins的 系统管理 → 邮件通知 中仅填写普通密码，即使账号正确也无法通过认证。

三、配置流程详解与关键参数设置

1. 进入 Jenkins 系统管理 → 系统配置
2. 找到“邮件通知”区域，填写 SMTP 服务器地址（如 smtp.qq.com）
3. 设置 SMTP 端口：SSL 使用 465，TLS 使用 587
4. 勾选“使用 SSL”或“使用 TLS”，依据服务商要求选择其一
5. 用户名填写完整邮箱地址（如 [e-mail]）
6. 密码栏输入邮箱生成的“授权码”而非登录密码
7. 验证“系统管理员邮件地址”字段是否与发件人一致
8. 点击“测试邮件”按钮，并观察控制台输出
9. 检查 Jenkins 主节点日志文件（jenkins.log）中的详细错误信息
10. 确认网络层面无防火墙拦截对外 465/587 端口连接

// 示例：Jenkins Location 配置片段（config.xml）
<mailer>
  <smtpServer>smtp.qq.com</smtpServer>
  <smtpPort>465</smtpPort>
  <useSsl>true</useSsl>
  <authUser>[e-mail]</authUser>
  <authPassword>your_authorization_code_here</authPassword>
  <charset>UTF-8</charset>
</mailer>

四、诊断路径与高级排错方法

graph TD
    A[无法发送测试邮件] --> B{检查Jenkins日志}
    B --> C[认证失败?]
    C -->|Yes| D[确认是否使用授权码]
    C -->|No| E[连接超时?]
    E -->|Yes| F[检查网络连通性]
    F --> G[telnet smtp.qq.com 465]
    G --> H[是否可通]
    H -->|No| I[防火墙或代理阻断]
    H -->|Yes| J[检查SSL/TLS配置]
    D --> K[登录邮箱开启SMTP权限]
    K --> L[获取新授权码并更新配置]

当标准配置无效时，建议使用命令行工具进行底层验证：

# 测试SMTP连接（OpenSSL）
openssl s_client -connect smtp.qq.com:465 -crlf -quiet

# 在交互模式下输入：
AUTH LOGIN
[base64编码的邮箱]
[base64编码的授权码]

此方式可绕过Jenkins界面限制，直接验证SMTP服务可达性和认证逻辑。