在 Docker 部署的 Jenkins 环境中生成的 Allure 报告缺少 `allure.step` 定义的内容，通常与以下几个原因有关： ### 1. **测试框架和 Allure 插件版本不兼容** - 如果使用的 `pytest-allure-adaptor` 或 `allure-pytest` 版本较旧，可能无法正确识别或处理 `@allure.step` 注解。 - 解决方法是升级到最新版本的 Allure pytest 插件，并确保其与当前 Python 和 Pytest 版本兼容[^2]。 ### 2. **未正确安装 Allure 命令行工具** - 在容器内运行测试时，如果缺少 Allure CLI 工具，或者其版本过低，可能导致报告生成不完整。 - 应确保在 Jenkins 容器内部或构建节点上正确安装了 Allure 命令行工具，并将其路径加入环境变量 PATH 中。可以使用如下命令安装： ```bash wget https://repo1.maven.org/maven2/io/qameta/allure/allure-commandline/2.13.8/allure-commandline-2.13.8.zip unzip allure-commandline-2.13.8.zip -d /usr/local/ ln -s /usr/local/allure-2.13.8/bin/allure /usr/local/bin/allure ``` 这样可以保证 `allure generate` 能够正确解析并生成包含 `step` 的报告。 ### 3. **测试执行过程中未启用 Allure 监听器** - 在运行 `pytest` 时，如果没有添加适当的参数来启用 Allure 报告收集，则不会记录步骤信息。 - 应在 Jenkins 构建脚本中使用以下命令运行测试： ```bash pytest --alluredir=./allure-results ``` 这将确保所有装饰器（如 `@allure.step`）被正确捕获并写入结果目录中[^2]。 ### 4. **Allure 结果目录路径错误或未持久化** - Jenkins 构建过程中产生的 `allure-results` 目录如果没有被正确挂载或持久化，可能导致报告生成时找不到原始数据。 - 在启动 Jenkins 容器时应通过 `-v` 参数将宿主机上的某个目录挂载为 `/var/jenkins_home`，例如： ```bash docker run -d -uroot -p 8989:8080 --name jenkins1 \ -v /home/hep/jenkins_node:/var/jenkins_home \ jenkins/jenkins:2.289.3-centos ``` 此外，在 Jenkinsfile 中定义的 `allure generate` 命令也应指向正确的源目录和输出目录[^3]。 ### 5. **Jenkins Allure 插件配置问题** - Jenkins 上需安装 Allure Jenkins 插件，并在全局工具配置中设置好 Allure 命令行路径。 - 在 Jenkins 的 pipeline 配置中，应明确调用 `allure` 步骤以发布报告，示例代码如下： ```groovy post { always { allure([ includeProperties: false, jdk: '', properties: [], reportBuildPolicy: 'ALWAYS', results: [[path: 'allure-results']] ]) } } ``` 这样可以确保 Jenkins 能够正确识别并展示包含 `step` 的详细步骤信息。 ### 6. **Python 测试代码中的 `allure.step` 使用方式不当** - `@allure.step` 只能用于函数或方法级别，不能直接嵌套在其他装饰器下方，否则可能会导致失效。 - 示例正确用法： ```python import allure @allure.step("输入用户名 {username}") def input_username(username): print(f"输入用户名：{username}") ``` 如果存在多层装饰器，应确保 `@allure.step` 处于最外