AWS CodeBuild中Playwright无头模式与HTML报告生成导致测试失败

问题复盘 #

• 测试全通过时报告生成正常，但测试失败时，Playwright尝试自动打开本地报告浏览器，CodeBuild无桌面环境导致构建报错
• 配置headless: true和reporter: [['html', { open: 'never' }]]后本地正常，但CodeBuild上执行npm run test --reporter=html出现命令退出错误，且上传制品时找不到报告文件

解决方案 #

1. 修正Playwright配置文件

编辑playwright.config.js，明确配置报告规则与输出目录，避免命令行参数冲突：

module.exports = {
  use: {
    headless: true, // CI环境默认无头，显式声明避免歧义
    // 其他测试配置（如baseURL、viewport等）
  },
  reporter: [
    ['html', {
      open: 'never', // 彻底禁用自动打开报告
      outputFolder: 'playwright-report' // 指定固定报告输出目录，方便后续制品上传
    }]
  ]
};

2. 调整CodeBuild测试命令

移除命令行中重复的--reporter=html参数，避免覆盖配置文件的设置：

npm run test

3. 配置CodeBuild制品上传路径

在buildspec.yml中指定正确的报告文件路径，确保构建后能找到并上传报告：

version: 0.2

phases:
  install:
    commands:
      - npm install
      - npx playwright install --with-deps # 确保CI环境安装完整的Playwright浏览器依赖
  build:
    commands:
      - npm run test
artifacts:
  files:
    - 'playwright-report/**/*' # 匹配报告目录下所有文件
  base-directory: '.' # 基于项目根目录定位文件

额外说明

• CodeBuild属于无桌面的CI环境，必须确保Playwright以无头模式运行（默认已开启，显式声明更稳妥）
• 命令行指定--reporter会覆盖配置文件中的设置，导致open: 'never'不生效，进而引发之前的浏览器启动错误
• 固定报告输出目录可以避免路径歧义，确保制品上传阶段能准确定位文件

内容的提问来源于stack exchange，提问作者HARI PRASAD