Jenkins：email-ext与Token Macro插件配合时部分检测类Token为空如何解决？

我之前在维护Jenkins旧版本（和你用的v2.163相近）时也碰到过一模一样的问题，CHECKSTYLE_COUNT、PMD_COUNT这类Token为空，本质上是静态代码分析插件的结果没被Token Macro正确识别到。下面是按优先级排序的排查和解决步骤：

1. 先确认静态代码分析插件已成功捕获报告结果 #

这是最常见的原因——如果Jenkins根本没拿到Checkstyle/PMD/DRY的分析结果，自然不会生成对应的Token。你可以这么验证：

• 打开某次构建的详情页，查看页面左侧或顶部是否有Checkstyle、PMD的结果入口（比如「Checkstyle Warnings」面板），里面是否有具体的问题数统计。
• 如果没有这个面板，说明你漏了构建后步骤配置：回到项目配置的「构建后操作」，添加「Publish Checkstyle analysis results」「Publish PMD analysis results」「Publish Duplicate Code Analysis Results」（对应DRY）这些步骤，并且指定正确的报告文件路径（比如Checkstyle的target/checkstyle-result.xml，根据你的构建工具调整）。
• 重新触发一次构建，确认分析结果面板出现后，再测试邮件。

2. 调整构建后步骤的执行顺序 #

email-ext的邮件发送步骤必须放在静态代码分析报告发布步骤的后面。如果邮件先执行，此时分析结果还没生成，Token自然是空的：

• 回到项目配置的「构建后操作」，把「Editable Email Notification」拖拽到所有静态代码分析发布步骤的下方，保存后重新构建测试。

3. 检查插件版本兼容性 #

你的Jenkins v2.163属于较旧版本，Token Macro和静态代码分析插件（Checkstyle、PMD等）可能存在适配问题：

• 进入Jenkins的「插件管理」，找到这些插件，选择和Jenkins v2.163兼容的稳定更新版本（注意不要直接更到最新版，选标注“兼容v2.163”的版本）。
• 更新前建议备份Jenkins配置文件，避免出现其他问题。

4. 验证Token的拼写和使用上下文 #

• 确保Token拼写完全正确，比如CHECKSTYLE_COUNT是全大写，不要出现大小写错误或拼写失误（比如把DRY_COUNT写成DRY_COUNTS）。可以直接从项目配置页的「Content Token Reference」里复制Token，避免手动输入出错。
• 如果是多分支项目，确认这些Token支持多分支环境——部分旧版本插件的Token在多分支项目下可能无法正确获取结果，可先在单分支项目中测试排除环境问题。

5. 排查权限与全局配置问题 #

极少数情况下，Jenkins的全局安全设置会限制插件间的数据共享：

• 暂时放宽权限测试：进入「全局安全配置」，把「授权策略」临时改成「任何人都可以做任何事」（测试完成后改回原配置），重新构建后查看邮件是否能正常显示Token。
• 如果放宽权限后Token正常，说明是权限配置问题，需要给email-ext插件对应权限，确保它能读取静态代码分析插件的结果数据。

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