Jenkins执行Playwright回归测试失败及环境配置等问题咨询

1. 确认Jenkins配置环境是否正确 #

• 对比本地与Jenkins的依赖版本：在Jenkins构建脚本中加入node -v、npm -v、npx playwright --version，将输出结果和本地执行的对应命令结果对比，确保Node.js、Playwright版本完全一致
• 验证Playwright浏览器安装状态：在构建步骤里添加npx playwright install --with-deps，强制安装对应浏览器及依赖，同时执行npx playwright browsers list查看已安装浏览器列表，确认和本地环境匹配
• 检查Jenkins工作目录权限：在构建脚本中加入ls -la查看工作目录权限，或尝试执行touch test-permission.txt验证Jenkins运行用户是否有读写权限
• 核对环境变量：本地执行printenv（Linux/macOS）或set（Windows）导出环境变量，在Jenkins构建脚本中执行同样命令，对比PATH、NODE_PATH等关键变量是否一致

2. 在控制台输出中查看验证信息 #

• 直接在构建脚本开头添加环境验证命令，输出核心信息：

  echo "=== 环境信息验证 ==="
  node -v
  npm -v
  npx playwright --version
  npx playwright browsers list
  echo "=== 工作目录内容 ==="
  ls -la
  echo "=== 环境变量 ==="
  printenv
  

• 提升Playwright日志级别：在测试运行命令前加入DEBUG=pw:*（Linux/macOS）或set DEBUG=pw:*（Windows），比如DEBUG=pw:* npx playwright test，控制台会输出浏览器启动、页面加载等全流程调试日志
• 开启测试追踪日志：在Playwright配置文件（playwright.config.js）中设置use: { trace: 'on' }，测试失败后会生成trace文件，可下载到本地用npx playwright show-trace查看执行细节，也能在构建控制台输出实时测试日志

3. 解决index.html显示不稳定的问题 #

• 改用智能等待逻辑：放弃固定时长等待，使用Playwright内置方法，比如await page.waitForLoadState('networkidle')（等待网络空闲）或await page.waitForSelector('#关键元素ID')（等待核心渲染元素加载完成），确保页面完全渲染后再执行后续操作
• 排查Jenkins节点网络稳定性：在构建脚本中加入ping 你的Web应用域名 -c 10（Linux/macOS）或ping 你的Web应用域名 -n 10（Windows），查看丢包率；也可以用curl -v 你的Web应用URL输出请求详情，排查是否存在请求超时或异常
• 禁用浏览器缓存：在Playwright配置中添加use: { contextOptions: { extraHTTPHeaders: { 'Cache-Control': 'no-cache' } } }，强制浏览器每次请求最新页面资源
• 确保Web应用完全启动：如果Web应用和测试脚本在Jenkins中一同启动，需先验证应用健康状态，比如循环调用应用的健康检查接口，直到返回200状态码再启动测试

内容的提问来源于stack exchange，提问作者Annie Chuechamnan