Azure Windows Server 2019虚拟机Jenkins邮件通知配置测试失败求助

我来帮你一步步排查这个Jenkins邮件通知的问题，结合你在Azure Windows Server上的场景，咱们从网络到配置逐层梳理：

一、先确认Azure层面的网络限制（最容易忽略的点） #

Azure虚拟机的网络访问不光受本地Windows防火墙控制，还受**网络安全组(NSG)**的约束，先检查这一点：

• 登录Azure门户，找到你的虚拟机，进入它关联的网络安全组
• 查看出站规则，确保已经添加了允许TCP 465、587端口到0.0.0.0/0的规则（优先级要高于默认的拒绝规则）
• 验证网络连通性：在Windows Server的命令提示符里运行telnet smtp.gmail.com 465或telnet smtp.gmail.com 587，如果连接成功会进入空白窗口；如果失败，说明网络层面还有阻塞，再回头检查NSG和本地防火墙的规则是否生效

二、Jenkins系统配置的细节核对 #

如果网络连通性没问题，那大概率是配置参数的细节出错了，以Gmail为例：

• SMTP服务器：必须填smtp.gmail.com，不能简写
• 端口与加密方式：465对应SSL加密，587对应STARTTLS加密，两者不能混用
• 用户名与发件人：必须是你的完整Gmail邮箱地址（比如xxx@gmail.com），且发件人地址要和用户名完全一致
• 密码注意事项：
  • 如果你关闭了两步验证，要确认「允许低安全性应用访问」确实已经启用（有时候设置后需要等待5-10分钟才会生效）
• 查看Jenkins日志定位错误：进入Manage Jenkins -> System Log，临时将日志级别改为DEBUG，然后测试邮件发送，日志里会给出具体错误（比如认证失败、连接超时），这比只看「测试失败」有用得多

三、Gmail账户的额外排查 #

Gmail的安全机制有时候会拦截陌生设备的登录：

• 登录你的Gmail账户，进入「安全中心」，查看有没有「可疑登录活动」的提醒，点击「这是我」允许该登录请求，然后再回到Jenkins测试

四、Pipeline层面的直接验证 #

如果系统配置界面一直测试失败，可以跳过系统配置，直接用Pipeline代码测试，排除界面配置的潜在问题：

pipeline {
    agent any
    stages {
        stage('Test Mail Notification') {
            steps {
                echo 'Attempting to send test mail...'
            }
        }
    }
    post {
        always {
            mail to: 'your-recipient@example.com',
                 subject: 'Jenkins Pipeline Test Mail',
                 body: 'This is a test email sent directly from Jenkins Pipeline.',
                 from: 'your-gmail-account@gmail.com',
                 smtpServer: 'smtp.gmail.com',
                 smtpPort: '465',
                 smtpAuth: true,
                 smtpUsername: 'your-gmail-account@gmail.com',
                 smtpPassword: credentials('gmail-smtp-password'),
                 ssl: true
        }
    }
}

注意：这里用credentials('gmail-smtp-password')是建议你在Jenkins的「Manage Jenkins -> Manage Credentials」里添加一个密码凭证，避免明文泄露。如果这段Pipeline能发送成功，说明系统配置界面的某个参数有误；如果还是失败，那问题还是出在网络或账户权限上。

五、代理设置排查（如果你的虚拟机需要代理上网） #

如果Azure虚拟机需要通过代理访问外部网络，别忘了给Jenkins配置代理：

• 进入Manage Jenkins -> Manage Plugins -> Advanced
• 在「HTTP Proxy Configuration」里填写代理服务器地址和端口，同时在「No Proxy Hosts」里添加smtp.gmail.com（避免SMTP请求走代理）

内容的提问来源于stack exchange，提问作者xbalaj