如何修复Jenkins扩展邮件插件‘尝试向空收件人列表发送邮件，已忽略’错误？

结合你使用的Jenkins 2.11版本、扩展邮件插件v1.61，以及Blue Ocean创建Pipeline的场景，这个时好时坏的空收件人问题，主要和Pipeline环境下全局配置的继承逻辑、不同构建触发场景的收件人解析差异有关。下面是具体的排查和解决步骤：

1. 在Jenkinsfile中显式指定收件人，避免依赖全局默认 #

旧版本的扩展邮件插件在Pipeline环境下，有时无法正确读取全局配置的默认收件人，尤其是Blue Ocean构建的上下文和传统自由风格项目有差异。你可以直接在emailext步骤中显式添加收件人，确保无论什么场景都有明确的接收者：

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                // 你的构建步骤
            }
        }
    }
    post {
        always {
            emailext (
                subject: 'Build ${BUILD_STATUS}: ${PROJECT_NAME} #${BUILD_NUMBER}',
                body: '构建详情：${BUILD_URL}',
                // 显式指定固定收件人
                to: 'your-team@example.com',
                // 可选：保留收件人提供者（比如开发者、构建发起者）
                recipientProviders: [
                    [$class: 'DevelopersRecipientProvider'],
                    [$class: 'RequesterRecipientProvider']
                ]
            )
        }
        failure {
            // 可以针对失败场景单独配置邮件内容，同样显式指定收件人
            emailext (
                subject: 'FAILED: ${PROJECT_NAME} #${BUILD_NUMBER}',
                body: '构建失败，请查看：${BUILD_URL}',
                to: 'your-team@example.com'
            )
        }
    }
}

这样即使全局配置的收件人没被加载，也能保证有明确的收件人列表。

2. 检查全局扩展邮件插件的默认收件人配置 #

登录Jenkins管理界面，进入系统管理 → 系统设置 → Extended E-mail Notification，确认Default Recipients字段已经填写了有效的邮箱地址，并且勾选了Allow sending to unregistered users（如果收件人不是Jenkins用户的话）。旧版本插件中，这个字段为空的话，在Pipeline场景下不会自动补充其他收件人，就会出现空列表的错误。

3. 排查不同构建触发场景的差异 #

你提到问题是"有时能发，有时不能"，大概率和构建的触发方式有关：

• 手动触发（Blue Ocean界面点击构建）：此时RequesterRecipientProvider能获取到发起者的邮箱，所以收件人列表有效；
• 定时触发、SCM自动触发：这类场景没有明确的"请求者"，如果你的收件人仅依赖RequesterRecipientProvider，就会导致收件人列表为空。

解决方法：要么补充固定收件人（参考步骤1），要么针对不同触发方式调整收件人逻辑，比如：

script {
    def triggerCause = currentBuild.getBuildCauses()[0].shortDescription
    def recipients = 'default-team@example.com'
    // 如果是手动触发，额外添加发起者邮箱
    if (triggerCause.contains('Started by user')) {
        recipients += ", ${currentBuild.getBuildCauses()[0].userId}@example.com"
    }
    emailext to: recipients, subject: '...', body: '...'
}

4. 调试收件人解析结果 #

为了定位具体是哪种场景导致的空列表，你可以在Jenkinsfile中添加调试步骤，打印解析后的收件人：

post {
    always {
        script {
            // 解析收件人列表并打印
            def resolvedRecipients = emailextrecipients([
                [$class: 'DevelopersRecipientProvider'],
                [$class: 'RequesterRecipientProvider']
            ])
            echo "Resolved email recipients: ${resolvedRecipients}"
        }
        emailext to: resolvedRecipients ?: 'fallback@example.com', subject: '...', body: '...'
    }
}

这样在构建日志中就能看到每次构建的收件人是否为空，从而对应到具体的触发场景或配置问题。

5. 考虑插件版本的兼容性（谨慎操作） #

Jenkins 2.11和扩展邮件插件v1.61都是比较老旧的版本（2017年左右发布），可能存在已知的Pipeline兼容性bug。如果你能在测试环境验证，可以尝试升级扩展邮件插件到该Jenkins版本支持的最高兼容版本（注意：不要直接跨大版本升级，避免兼容性问题），或者查看该版本插件的官方issue，确认是否有类似的空收件人问题。

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