### 解决 Pytest HTML 报告 404 错误 当使用 `pytest` 和 `allure-pytest` 插件生成并打开 HTML 报告时，如果遇到 404 错误，通常是因为报告文件未被正确生成或路径配置不正确。以下是可能的原因及其解决方案： #### 可能原因分析 1. **插件安装问题**: 如果使用的插件版本过旧或者名称错误，则可能导致功能异常[^1]。 2. **命令执行顺序不当**: 使用 `--html=report.html` 参数生成报告时，如果没有正确指定路径或参数位置不对，也可能引发此问题。 3. **浏览器缓存影响**: 浏览器可能会加载之前的缓存页面而不是最新的报告内容。 #### 解决方案 ##### 方法一：确认插件安装无误 确保已卸载旧版插件并重新安装最新支持的插件： ```bash pip uninstall pytest-allure-adaptor pip install allure-pytest ``` ##### 方法二：调整运行命令 在运行测试脚本时，需明确指定生成 HTML 报告所需的参数。例如： ```bash pytest --html=./reports/report.html tests/ ``` 上述命令会在当前目录下的 `./reports/` 文件夹中创建名为 `report.html` 的报告文件。 ##### 方法三：清除浏览器缓存 尝试通过以下方式访问新生成的报告以排除缓存干扰： - 手动删除浏览器历史记录中的缓存； - 或者直接右键保存本地 HTML 文件并通过其他工具（如 VSCode Live Server）预览。 ##### 方法四：验证报告结构完整性 检查生成后的 HTML 文件是否存在依赖资源缺失的情况。比如 CSS 样式表链接断开等问题均会致使显示失败。可以利用开发者模式审查元素定位具体错误来源[^4]。 --- ### 示例代码片段 下面是一个简单的 Python 脚本用于演示如何配合 `pytest-html` 来生成基本测试结果报表： ```python import unittest from selenium import webdriver class TestExample(unittest.TestCase): @classmethod def setUpClass(cls): cls.driver = webdriver.Chrome() def test_example(self): self.driver.get("http://example.com") title = self.driver.title assert "Example Domain" in title, f"Title mismatch {title}" @classmethod def tearDownClass(cls): errors = [] result = getattr(cls, '_outcomeForDoCleanups', None).errors if hasattr(result, 'failures'): failures = [failure[1] for failure in result.failures] errors.extend(failures) elif isinstance(result, list): errors.extend([error[1] for error in result]) # Feed any collected errors back into the final results object. cls._feedErrorsToResult(errors, cls._outcome.errors) if __name__ == "__main__": unittest.main() ``` 注意这里调用了 `_feedErrorsToResult()` 函数来处理单元测试框架内的状态更新逻辑[^2]。 --- ### 总结 综上所述，针对 `pytest html report 404 error` 这类现象可以从环境准备、操作流程以及最终产物质量三个方面逐一排查直至找到根本诱因加以修正即可恢复正常运作。