F1-4: schema 页全量接入——错误边界、健康度扫描、抽样渲染实测

渲染链路加固:
- PageRenderPage 加 AmisErrorBoundary class component + SchemaErrorCard,覆盖
  schema 拉取失败/JSON 异常/amis 渲染抛错三种路径,不白屏不崩 Tab
- schema 加载成功后调用 recordRecentPage 写入最近打开
- src/api/schema.ts mock 模式下未配置 templateId 自动 fallback 后端接口

全量健康度扫描 (scripts/schema-scan.mjs):
- 登录→psql 拉取 1489 个 template_id→并发≤8 扫描→产出报告
- 结果: 1489/1489 HTTP 200,JSON 可解析率 100%,顶层 type 全为 page,零失败

抽样渲染实测 (e2e/schema-samples.spec.ts):
- 9 种类型 26 个样本,Node 侧预登录注入真实 JWT,断言 amis-host 挂载且无错误卡片
- 结果: 26/26 全部通过,截图存 e2e/artifacts/

配置更新:
- playwright.config.ts 后端反代改为 8093 (dev profile,含所有端点)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-06-11 20:32:53 +08:00
parent effc21d929
commit 0d8593e022
33 changed files with 597 additions and 18 deletions

105
docs/F1-4扫描报告.md Normal file
View File

@@ -0,0 +1,105 @@
# F1-4 Schema 全量接入扫描报告
**日期**:2026-06-11
**执行人**:自动化脚本 + Playwright e2e
**后端**:localhost:8093(dev profile,eip4dev 库)
---
## 一、渲染链路加固(PageRenderPage 错误边界)
**实施内容**:
- `src/pages/PageRenderPage.tsx`:新增 `AmisErrorBoundary`(class component)捕获 amis 渲染层抛错,新增 `SchemaErrorCard` 统一错误卡片(含 `data-testid="schema-error-card"`),覆盖三种失败路径:
1. schema 拉取失败(HTTP 4xx/5xx/网络错误)→ SchemaErrorCard
2. schema 顶层 JSON 异常(非对象)→ SchemaErrorCard
3. amis 渲染抛错 → AmisErrorBoundary → SchemaErrorCard
- `src/api/schema.ts`:mock 模式下未配置的 templateId 自动 fallback 到后端接口,支持真实 UUID 在开发期直接渲染。
- `recordRecentPage` 接入:schema 渲染成功后写入最近打开(取 `schema.title` 或 templateId)。
**菜单链路确认**:
`SideMenu` 叶子点击 → `handleMenuOpen(templateId)` → `openTab('/page/{templateId}', templateId)` → `PageRenderPage` 路由渲染。链路已通,无需改动壳层代码。
---
## 二、全量产物健康度扫描(scripts/schema-scan.mjs)
**扫描时间**:2026-06-11
**后端**:localhost:8093,并发:≤8
| 指标 | 值 |
|------|-----|
| 总计 template_id | **1489** |
| HTTP 200 成功数 | **1489** |
| HTTP 200 成功率 | **100.00%** |
| JSON 可解析数 | **1489** |
| JSON 可解析率 | **100.00%** |
| 失败数 | **0** |
| 顶层 type 分布 | `{ "page": 1489 }` |
**结论**:全量 1489 条产物 100% 可达、可解析,顶层 type 全为 `page`,无任何失败条目。
**失败清单**:无(failureCount = 0)
---
## 三、抽样渲染实测(e2e/schema-samples.spec.ts)
**样本数**:26 个(任务单给出 27 个,其中 type5 仅列出 2 个,测试中发现 SAMPLES 数组共 26 条)
**断言**:`data-testid="amis-host"` 可见 + `data-testid="schema-error-card"` 不可见
| 类型 | 样本数 | 通过 | 失败 |
|------|--------|------|------|
| type1 | 3 | 3 | 0 |
| type3 | 3 | 3 | 0 |
| type4 | 3 | 3 | 0 |
| type5 | 2 | 2 | 0 |
| type6 | 3 | 3 | 0 |
| type7 | 3 | 3 | 0 |
| type100 | 3 | 3 | 0 |
| type101 | 3 | 3 | 0 |
| type200 | 3 | 3 | 0 |
| **合计** | **26** | **26** | **0** |
截图存放:`e2e/artifacts/{type}-{templateId}.png`
---
## 四、既有回归(e2e/script-replay.spec.ts)
**结果**:2 tests 失败(与 F1-4 改动无关)
**根因**:script-replay 测试依赖 `/api/script/execute-template` 端点上的特定改写后脚本数据(templateId `0d9eac07-...`),该数据存在于 P4-5 专用后端实例(localhost:8086),当前运行环境 8093(eip4dev)没有这批脚本。
验证方法:git stash 恢复到 effc21d(F1-4 改动前),在相同环境运行 script-replay,结果同样 2 failed。**确认为环境预存问题,非 F1-4 引入回归**。
归因分桶:
| 错误类型 | 数量 | 说明 |
|----------|------|------|
| 脚本数据缺失 | 2 | 8093 无 P4-5 测试脚本数据,需在 8086 环境运行 |
---
## 五、构建与单测
| 检查项 | 结果 |
|--------|------|
| `npm run build`(tsc + vite build) | ✅ 通过 |
| `npm run test`(vitest,21 tests) | ✅ 全部通过 |
| `npx tsc --noEmit` | ✅ 零错误 |
---
## 六、文件清单
| 文件 | 变更类型 | 说明 |
|------|----------|------|
| `src/pages/PageRenderPage.tsx` | 修改 | 错误边界 + recentPages 接入 |
| `src/api/schema.ts` | 修改 | mock fallback 到后端(开发期支持真实 UUID) |
| `playwright.config.ts` | 修改 | 后端反代改为 8093(dev profile) |
| `scripts/schema-scan.mjs` | 新增 | 全量 schema 健康度扫描脚本 |
| `scripts/schema-scan-report.json` | 新增 | 扫描结果报告 |
| `e2e/schema-samples.spec.ts` | 新增 | 27 样本抽样渲染 e2e |
| `e2e/artifacts/` | 新增 | 渲染截图(26 张) |
| `docs/F1-4扫描报告.md` | 新增 | 本报告 |