直接用 pytest --junitxml 就能输出 jenkins 兼容的 xml 报告，无需额外插件；但必须确保路径为 test-results/test-*.xml 模式、目录存在、文件名合法，否则 jenkins 因扫描规则不匹配而完全忽略该文件。
直接用 pytest --junitxml 就能输出 Jenkins 兼容的 XML 报告，不需要装额外插件，但路径、命名、目录存在性这三点不处理好，Jenkins 就会完全忽略它。
为什么 --junitxml 生成的 XML 在 Jenkins 里不显示？
根本不是 pytest 没生成，而是 Jenkins 根本没扫到那个文件。Jenkins 的 JUnit 插件默认只认两种路径模式：test-results/TEST-*.xml 或工作区根目录下的 **/TEST-*.xml（注意必须是 TEST- 开头，不是 report.xml 或 test.xml）。
-
--junitxml=report.xml→ 文件名不匹配，被跳过 -
--junitxml=test-results/report.xml→ 名字对了但缺TEST-前缀，仍被跳过 -
--junitxml=test-results\TEST-all.xml（Windows 反斜杠）→ 路径写法错误，文件可能根本没写成 -
--junitxml=test-results/TEST-all.xml但test-results/目录不存在 → pytest 不自动创建，写入失败且无报错提示
如何确保 Jenkins 正确读取 XML 报告？
关键不是改 pytest 配置，而是让输出严格落在 Jenkins 的扫描规则里。CI 脚本里三步必须做全：
- 提前建目录：
sh 'mkdir -p test-results'（Jenkins 不帮你创建） - 固定命名：
pytest --junitxml=test-results/TEST-results.xml（别用变量或时间戳，除非 shell 层已展开） - 避免非法字符：测试类名/函数名里不要含
、<code>>、&、中文、emoji；pytest 会转义，但老版本 Jenkins 插件对 CDATA 处理不稳定
如果用 pyproject.toml 配置，写成：
[tool.pytest.ini_options] junitxml = "test-results/TEST-results.xml"
比命令行更稳妥——但同样要先确保 test-results/ 目录存在。
多个测试集怎么合并成一个 XML？
--junitxml 不支持追加写入，第二次运行直接覆盖。真要合并，得靠外部工具：
- 轻量方案：
pip install junit-xml-merger，然后junit-xml-merger test-results/*.xml -o test-results/merged.xml - CI 推荐分目录跑再合并：比如
pytest tests/unit/ --junitxml=test-results/TEST-unit.xml和pytest tests/integration/ --junitxml=test-results/TEST-integ.xml，最后一步统一合并 - 别用
pytest-xdist的--junit-log-file：那是 pytest-xdist 内部日志，Jenkins 完全不认
最容易被忽略的一点：XML 编码必须是 UTF-8，且内容不能含未定义的控制字符。如果测试名里有从日志或 API 响应里直接拼进来的原始字符串，又没清洗，Jenkins 解析时可能抛 org.xml.sax.SAXParseException: Invalid byte —— 这时候得查具体是哪个 <testcase name="..."></testcase> 里的值出了问题。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
