diff --git a/.github/workflows/backend-quality-gate.yml b/.github/workflows/backend-quality-gate.yml index 1609f001..c3de0aec 100644 --- a/.github/workflows/backend-quality-gate.yml +++ b/.github/workflows/backend-quality-gate.yml @@ -50,7 +50,7 @@ jobs: python -m pip install --upgrade pip python -m pip install -r requirements.txt -r requirements-dev.txt python -m pip install playwright - python -m playwright install --with-deps chromium + python -m playwright install --with-deps chrome npm ci --prefix frontend - name: Run Python quick quality gate diff --git a/docs/BUG_HISTORY.md b/docs/BUG_HISTORY.md index 38fbc170..2ed8cf16 100644 --- a/docs/BUG_HISTORY.md +++ b/docs/BUG_HISTORY.md @@ -1519,17 +1519,17 @@ - 修复版本:待提交(本地可测) -## BUG-083 | staging 质量门未固定 Chromium 运行时导致真实浏览器验收偶发失败 +## BUG-083 | staging 质量门使用无可用 Linux sandbox 的浏览器运行时导致验收失败 - 状态:resolved - 首次发现:2026-07-27 - 最近更新:2026-07-27 - 影响面:生时校正 V4 的 390px 真实浏览器验收、staging 镜像发布与后续部署 - 用户现象:PR 质量门已通过且相同提交的其余 1031 个测试成功,但推送到 `staging` 后唯一的真实 Chromium 测试未能取得 DevTools 端口,导致不可变镜像未发布、部署未继续。 -- 触发条件:`backend-quality-gate.yml` 在未安装 Playwright Chromium 的 GitHub Runner 上执行真实浏览器合同,只能依赖 Runner 当时预装的系统 Chrome。 -- 根因:staging 质量门新增了真实 Chromium 测试,却没有像既有 `release-quality-gate.yml` 一样显式安装受控的 Playwright Chromium 与系统依赖;同一 SHA 因 Runner 自带浏览器状态不同出现一次通过、一次启动超时。 -- 修复:复用既有 release gate 的浏览器准备步骤,在 staging 质量门安装 Playwright 和其固定 Chromium 运行时后再执行前端测试;不跳过真实浏览器验收,不增加 `--no-sandbox`。 -- 验证:workflow 合同回归断言 Playwright Chromium 必须被安装;聚焦部署合同测试、完整前端测试、目标 ESLint、生产构建与 `git diff --check` 通过;staging 质量门和部署结果另行记录。 -- 防复发:任何 CI 中的真实浏览器合同都必须由 workflow 显式供应浏览器版本与系统依赖,不能依赖 hosted runner 的偶然预装状态。 +- 触发条件:`backend-quality-gate.yml` 未显式供应带系统 sandbox 的浏览器,或安装 Playwright 默认的 `chromium-headless-shell` 后直接用原始二进制启动。 +- 根因:真实浏览器测试刻意保留 Chromium sandbox,但 Playwright 默认下载的 `chromium-headless-shell` 是原始构建;当前 GitHub Linux Runner 无法为该原始二进制建立所需 sandbox,进程以 `SIGTRAP` 退出。仅依赖 Runner 偶然预装的 Chrome 也不具备可重复性。 +- 修复:通过 Playwright 官方 `chrome` 安装通道供应系统级 stable Chrome 及其依赖,再执行真实浏览器合同;避免选择无系统 sandbox 包装的 headless shell,不跳过验收,也不增加 `--no-sandbox`。 +- 验证:workflow 合同回归断言 Playwright stable Chrome 必须被安装;聚焦部署合同测试、完整前端测试、目标 ESLint、生产构建与 `git diff --check` 通过;staging 质量门和部署结果另行记录。 +- 防复发:保留浏览器 sandbox 的 CI 必须使用具备系统 sandbox 包装的浏览器安装通道,不能直接启动无相应宿主配置的原始 headless shell,也不能依赖 hosted runner 的偶然预装状态。 - 相关记录:BUG-082 - 修复版本:本次修复提交 diff --git a/frontend/tests/staging-backend-workflows.test.ts b/frontend/tests/staging-backend-workflows.test.ts index f7aead50..2c849ddc 100644 --- a/frontend/tests/staging-backend-workflows.test.ts +++ b/frontend/tests/staging-backend-workflows.test.ts @@ -70,7 +70,7 @@ test("quality gate validates relevant changes once and publishes a digest manife assert.match(workflow, /workflow_dispatch:/); assert.equal((workflow.match(/npm test --prefix frontend/g) ?? []).length, 1); assert.match(workflow, /python -m pip install playwright/); - assert.match(workflow, /python -m playwright install --with-deps chromium/); + assert.match(workflow, /python -m playwright install --with-deps chrome/); assert.doesNotMatch(workflow, /npm run test:db --prefix frontend/); assert.match(workflow, /id: api_build[\s\S]*steps\.api_build\.outputs\.digest/); assert.match(workflow, /id: web_build[\s\S]*steps\.web_build\.outputs\.digest/);