必须使用--alluredir参数指定输出目录，如pytest tests/ --alluredir=./allure-results，否则不会生成Allure所需的JSON文件；仅安装allure-pytest插件而不加该参数将导致allure serve报“No tests found”。
Pytest运行时如何正确生成Allure所需的JSON结果文件
Allure不直接读取Pytest的原始输出，它依赖一套结构化的JSON测试结果。必须通过pytest的--alluredir参数指定输出目录，否则allure serve会报No tests found或Could not find any allure results。
常见错误是只装了allure-pytest但没加参数，或者路径写错（比如用了相对路径但当前工作目录不在预期位置）：
-
pytest tests/ --alluredir=./allure-results✅（推荐绝对路径或明确相对路径） -
pytest tests/ --alluredir=allure-results⚠️（容易因cd位置不同导致写入失败） -
pytest tests/❌（不会生成任何Allure数据）
注意：--alluredir会清空目标目录下已有的JSON文件，适合单次执行；若需合并多次运行结果，得用allure generate配合--clean手动控制。
为什么allure serve启动后页面空白或报404
最常见原因是Allure CLI未安装或版本不匹配。Pytest插件allure-pytest只是生成器，真正渲染靠本地allure命令行工具。
立即学习“Python免费学习笔记（深入）”；
验证方式：终端执行allure --version。若提示command not found，需单独安装Allure CLI（不是pip install allure）：
- macOS：
brew install allure或下载二进制包并加入$PATH - Windows：从
https://github.com/allure-framework/allure2/releases下载zip，解压后把bin/加进系统环境变量 - Linux：解压后用
chmod +x allure并软链到/usr/local/bin
另一个坑是端口被占——allure serve默认用5050，若冲突会静默失败。可显式指定：allure serve -p 5051 ./allure-results。
如何在Pytest中添加Allure专属标记（@feature、@story等）
Allure的标签不是装饰器语法糖，而是通过allure.模块函数注入，必须在测试函数内部调用，不能写在函数外或类定义里。
示例中易错点：
-
@allure.feature("登录模块")❌（这是旧版写法，现已被弃用） -
allure.feature("登录模块")✅（放在测试函数第一行） -
allure.step("输入用户名")可嵌套，但必须成对出现（with allure.step(...):更安全）
完整片段：
def test_login_success():
allure.feature("用户认证")
allure.story("正常登录流程")
with allure.step("打开登录页"):
driver.get("https://example.com/login")
with allure.step("提交表单"):
driver.find_element("id", "username").send_keys("admin")
driver.find_element("id", "password").send_keys("123")
driver.find_element("id", "submit").click()
这些调用会写入对应JSON字段，影响Allure报告中的分组和筛选逻辑。
CI环境中生成HTML报告失败的典型原因
GitLab CI / GitHub Actions里跑allure serve没用——它只是起一个本地HTTP服务，容器退出就没了。生产环境必须用allure generate导出静态HTML。
关键命令顺序：
- 先跑测试：
pytest tests/ --alluredir=$CI_PROJECT_DIR/allure-results - 再生成报告：
allure generate $CI_PROJECT_DIR/allure-results -o $CI_PROJECT_DIR/allure-report --clean - 最后把
allure-report/目录作为制品归档或Nginx托管
容易忽略的点：--clean参数必须加，否则历史报告残留会导致新结果不更新；另外allure-pytest版本要和CLI版本对齐（如CLI 2.22.x 对应插件 >=2.12.0），否则JSON schema不兼容，generate阶段可能静默跳过用例。
