Jenkins中newman使用htmlextra无法导出自定义命名HTML报表怎么办

问题根因 #

• 参数配置错误：你当前使用的--reporter-html-export是Newman原生HTML报告插件的参数，不属于htmlextra插件的专属配置参数，所以该配置不生效，htmlextra会按照默认规则生成带时间戳的报告文件。
• 双份文件来源：Jenkins工作空间下newman目录的文件是Newman执行命令直接生成的原生产物，.jenkins\jobs\Newman runner\htmlreports目录下的文件是你Jenkins项目中配置了「HTML报告发布」类的后置插件，自动收集工作空间的报告后生成的拷贝文件。

解决方法 #

1. 修正Newman执行命令，替换为htmlextra专属的导出参数，正确命令如下：

newman run IDMS4.postman_collection.json -e IDMS4.postman_environment.json --reporters cli,htmlextra --reporter-htmlextra-export newman/index.html --disable-unicode

执行修正后的命令后，Newman会直接在工作空间的newman目录下生成自定义命名的index.html，不会再生成带时间戳的默认命名文件。

2. 调整Jenkins项目后置配置

• 如果不需要在Jenkins项目归档目录保留报告拷贝，直接删除项目配置中「Publish HTML reports」类的后置步骤即可，仅保留执行Newman命令的构建步骤，最终只会生成一份newman/index.html文件。
• 如果需要保留Jenkins页面展示报告的功能，进入「Publish HTML reports」配置项，将索引页路径修改为newman/index.html，同时关闭插件自动生成时间戳命名报告的开关，插件就会直接读取你自定义命名的文件展示，不会生成额外的拷贝文件。

3. 验证效果：可以先在本地Windows终端执行修正后的Newman命令，确认可正常生成newman/index.html后，再到Jenkins中执行构建，避免工作空间路径、权限类问题影响配置生效。

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