pytest生成junit xml报告需显式指定完整文件路径（如--junitxml=test-results/test-results.xml），提前创建目录，加--junit-logs和--junit-family=xunit2提升可调试性。
Pytest 本身不自动输出 XML 报告，必须显式加 --junitxml 参数，且路径必须是具体文件（不能只写目录），否则静默失败——这是 CI 中最常踩的坑。
pytest --junitxml 必须指定完整文件路径
CI 脚本里写成 pytest --junitxml=test-results/ 或 --junitxml=test-results 不会报错，但也不生成任何 XML 文件。pytest 只接受带扩展名的完整路径。
- 正确写法：
pytest --junitxml=test-results/TEST-results.xml - 目录
test-results/必须提前创建，pytest 不会自动建父目录；Jenkins pipeline 中建议加sh 'mkdir -p test-results' - 路径避免用
~，比如--junitxml=~/report.xml会被当字面量处理，写入失败 - Windows 下也推荐用正斜杠
/，如reports/test.xml，pytest 内部兼容性更好
--junit-logs 和 --junit-family=xunit2 是调试关键
Jenkins 解析失败时经常看不到 traceback，根本原因是默认 XML 里不包含 stdout/stderr，且 <failure message="..."></failure> 里只放断言简短信息，没堆栈。
- 加
--junit-logs才能把print()输出和异常详情写进<system-out></system-out>和<system-err></system-err>标签 -
--junit-family=xunit2让message属性包含 traceback 第一行，比默认的xunit1更实用 -
--junit-logs从 pytest 6.2 起支持，旧版本（如 5.x）会报unrecognized arguments错误 - 如果用了
pytest-xdist并行，stdout/stderr 会混入同一 XML，顺序不可靠——这不是 bug，是设计如此
测试名和类名别碰 XML 特殊字符
虽然 pytest 会自动转义 、<code>>、& 等字符，但某些旧版 Jenkins JUnit 插件对 CDATA 处理不一致，可能导致解析失败或报告丢失。
- 稳妥做法：用
--junitprefix=test_统一前缀，避开命名冲突 - 避免在
class TestUserLogin或def test_user_<admin></admin>这类名字里直接嵌入 XML 符号 - CI 中优先用固定文件名（如
TEST-results.xml），别依赖$(date)—— shell 变量展开在某些 CI 环境下不可靠
真正卡住 CI 的往往不是语法错误，而是 --junitxml 路径没写全、test-results/ 目录不存在、或者没加 --junit-logs 导致失败原因不可见——这三处漏掉任意一个，Jenkins 就只能显示“测试通过数为 0”。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
