Jenkins中Allure报告嵌入邮件及附件遗留问题求助

问题1：邮件扩展插件使用Allure模板触发空指针异常 #

• 先查模板路径和权限：
  确认allure-report.groovy放在Jenkins的$JENKINS_HOME/email-templates目录下，且Jenkins运行用户拥有该目录的读取权限。如果是自定义模板，检查代码中是否直接引用了未初始化的变量（比如allureReport对象），可以在模板开头添加空值判断：

  if (allureReport == null) {
      return "Allure报告未生成或无法访问"
  }
  

• 换用Allure插件原生邮件通知：
  放弃邮件扩展插件的脚本模板，直接配置Allure Jenkins插件自带的「邮件通知」选项——该插件内置了Allure报告的邮件渲染逻辑，能避开自定义模板的空指针坑。
• 核对Allure报告路径配置：
  在Jenkins的Allure构建步骤中，确保「Report path」字段正确指向生成的Allure报告目录（比如allure-report），避免模板因找不到报告路径抛出空指针异常。

问题2：Allure附件目录遗留历史文件 #

• 构建前清理附件目录：
  在Jenkins的构建步骤中添加shell（Linux/macOS）或批处理（Windows）命令，放在测试执行前运行：
  Linux/macOS：

  rm -rf allure-report/data/attachments/* || true
  

  Windows：

  if exist allure-report\data\attachments\* del /Q allure-report\data\attachments\*
  

  加|| true是为了避免目录不存在时命令报错中断构建。
• 测试代码层面添加清理逻辑：
  在Behave的environment.py中添加钩子函数，在测试套件启动前清理附件目录（如果测试代码直接将附件写入Allure的attachments目录）：

  import os
  import shutil
  
  def before_all(context):
      attachments_dir = "allure-report/data/attachments"
      if os.path.exists(attachments_dir):
          shutil.rmtree(attachments_dir)
      os.makedirs(attachments_dir, exist_ok=True)
  

• 使用Workspace Cleanup插件：
  安装Jenkins的Workspace Cleanup插件，在构建配置中开启「Clean before build」，并指定仅清理allure-report/data/attachments目录，避免误删其他必要文件。

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