根本原因是xml文件未写入jenkins默认扫描路径或文件名含非法字符，导致junit插件忽略该文件；必须确保--junitxml指定路径符合test-results/test-*.xml模式、目录存在且文件编码合法。
pytest 本身就能生成 Jenkins 兼容的 XML 报告，不需要额外插件，但必须用 --junitxml 参数且避免常见路径/编码陷阱。
为什么 --junitxml 生成的 XML 在 Jenkins 里不显示测试结果？
根本原因通常是 XML 文件被写入了 Jenkins 不会扫描的路径，或文件名含非法字符（如空格、中文、冒号），导致 Jenkins 的 JUnit 插件解析失败。
- Jenkins 默认只扫描工作区根目录或
**/TEST-*.xml模式匹配的文件，--junitxml=report.xml生成的文件若不在扫描路径下，会被忽略 - Windows 下用
--junitxml=test-results\report.xml可能因反斜杠或路径不存在导致写入失败，建议统一用正斜杠 - pytest 默认用 UTF-8 写入 XML，但若测试用例名含特殊字符（如 emoji 或未转义的控制字符），Jenkins 解析时可能报
org.xml.sax.SAXParseException: Invalid byte
如何确保 pytest --junitxml 输出被 Jenkins 正确识别？
关键不是改 pytest 配置，而是让输出路径和命名符合 Jenkins 的默认约定。
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 在
pytest.ini或pyproject.toml中显式指定路径：junitxml = test-results/TEST-$(date +%Y%m%d-%H%M%S).xml（注意：变量展开需 shell 支持，CI 中推荐固定名） - CI 脚本中直接调用：
pytest --junitxml=test-results/TEST-results.xml，并确保test-results/目录存在（Jenkins 不自动创建） - 在 Jenkinsfile 中添加预处理步骤：
sh 'mkdir -p test-results' - 避免在测试函数名或类名中使用
、<code>>、&等 XML 特殊字符；pytest 会自动转义，但某些旧版 Jenkins 插件对 CDATA 处理不一致，稳妥做法是用pytest --junitprefix统一前缀规避命名冲突
--junitxml 和 --junit-log-file 有什么区别？
后者是 pytest-xdist 插件的参数，与 Jenkins 无关；Jenkins 只认标准 --junitxml 输出的 XML 格式，且必须符合 JUnit 4 schema（即包含 <testsuite></testsuite> 和嵌套的 <testcase></testcase>）。
-
--junitxml是 pytest 内置参数，生成标准 JUnit XML，Jenkins 原生支持 -
--junit-log-file是 pytest-xdist 的调试日志参数，输出的是纯文本日志，Jenkins 完全无法解析 - 不要混用
--junitxml和--junitprefix：前者指定文件路径，后者仅修改<testcase name=""></testcase>中的前缀字符串，不影响兼容性 - 如果用了
pytest-xdist并行执行，--junitxml仍能正确合并结果——前提是没加--dist=load以外的分发模式，否则需配合--junitxml+--junit-prefix避免 name 冲突
真正卡住人的往往不是参数怎么写，而是 Jenkins 工作区权限、XML 文件生成时机（比如测试失败时提前退出导致文件不完整）、以及 pytest 版本对 system-out 和 system-err 的字段处理差异。建议先本地运行 pytest --junitxml=test-results/TEST-local.xml && head -n 20 test-results/TEST-local.xml 确认开头是 <?xml 和 <testsuite>，再上传到 Jenkins。</testsuite>
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
