Jenkins中如何配置邮件通知

Jenkins 邮件通知配置指南

一 准备与插件安装

• 安装插件：进入 Manage Jenkins > Manage Plugins > Available，搜索并安装 Email Extension Plugin（建议同时保留内置的 Mailer Plugin）。前者支持更灵活的收件人、内容与触发器，后者提供基础邮件能力。
• 开启邮箱 SMTP 并获取授权码：在邮箱设置中开启 POP3/SMTP，生成授权码/应用专用密码（后续在 Jenkins 中作为密码使用，非网页登录密码）。
• 基础系统设置：进入 Manage Jenkins > System，在 Jenkins Location 填写 系统管理员邮件地址，该地址应与发件邮箱保持一致，避免发信异常。

二 全局邮件配置

• 内置 Mailer 插件（简单场景）

  • 位置：Manage Jenkins > System > E-mail Notification。
  • 关键项：SMTP server、SMTP Port（常用 25/587/465）、勾选 Use SMTP Authentication、按需勾选 Use SSL/TLS，填写邮箱与授权码。
  • 测试：使用页面底部的 Test configuration by sending test e-mail 发送测试邮件，确认连通性与账号可用。

• Extended E-mail Notification（推荐，功能更强）

  • 位置：Manage Jenkins > System > Extended E-mail Notification。
  • 关键项：SMTP server/Port、Use SMTP Authentication、Default Recipients（默认收件人）、Default Subject/Content、以及 Triggers（触发器，如 Always/Failure/Unstable 等）。
  • 调试：可开启 Enable Debug Mode 输出更详细日志；该区域通常无“Test”按钮，需通过构建后动作实际发送验证。

三 在任务中启用邮件通知

• Freestyle 任务

  • 构建后操作添加 E-mail Notification（基础）或 Editable Email Notification（扩展）。
  • 常用字段：Project Recipient List（收件人，逗号分隔）、Subject、Body；在 Advanced Settings > Triggers 勾选触发条件（如 Always、Failure、Unstable 等）。

• Pipeline 任务

  • 使用 emailext（扩展插件）在 post 阶段发送：

    pipeline {
      agent any
      stages {
        stage('Build') { steps { echo 'Building...' } }
        stage('Test')  { steps { echo 'Testing...' } }
      }
      post {
        always {
          emailext(
            subject: "Build ${currentBuild.currentResult}: ${env.JOB_NAME} #${env.BUILD_NUMBER}",
            body: "Check console output at ${env.BUILD_URL}",
            recipientProviders: [developers()]
          )
        }
      }
    }
    

  • 如需更丰富内容，可结合模板或自定义内容。

四 常用邮箱 SMTP 示例

五 常见问题与排查

• 连接超时/拒绝：确认已填写 System Admin e-mail address，SMTP 主机/端口正确，且服务器可访问外网 SMTP（如执行 telnet smtp.qq.com 465 测试连通性）。
• 认证失败：确认使用的是授权码/应用专用密码，而非网页登录密码；账号与发件人一致。
• 收不到邮件：检查 Triggers 是否勾选了正确事件；Freestyle 测试时可先用 Always 触发；Extended 插件无页面“Test”，需实际构建验证。
• 内容为空或异常：在 Extended 插件中开启 Enable Debug Mode，查看构建日志与插件日志定位变量与模板问题。