测试、发布与运维
测试分层
| 层级 | 重点 | 典型验证 |
|---|---|---|
| 单元测试 | 参数校验、权限判断、SQL 编译、样式 Schema | 边界值、空值、非法值、幂等 |
| 接口测试 | 鉴权、状态码、事务、审计、错误信息 | 401/403/404/409/422/502 |
| 集成测试 | 门户票据、Superset、报表、调度、元数据 | 免登录跳转、票据过期、服务不可用 |
| 端到端测试 | 用户从菜单进入并完成目标业务 | 生成多图表看板并调整样式 |
| 权限回归 | 角色、部门、数据集和导出边界 | 业务用户不能访问管理接口 |
| 安全测试 | 越权、注入、文件上传、敏感信息泄露 | 白名单、限流、日志脱敏 |
| 可用性测试 | 桌面与移动端、错误提示、加载超时 | 无横向溢出、可恢复 |
发布流程
- 合并前通过静态检查、单元测试和代码评审。
- 在测试环境执行数据库迁移、配置核对和冒烟测试。
- 验证所有外部服务健康状态及一次性票据通道。
- 在变更窗口按依赖顺序发布：数据库 → 后端 → 前端 → 集成配置。
- 发布后执行登录、菜单、看板、报表、大屏、建模、治理和 AI 核心链路检查。
- 观察错误率、响应时间和 502 日志；异常时按预案回滚。
运维监控
- 门户后端健康端点与关键接口成功率。
- Superset、JimuReport、GoView、DolphinScheduler、Hop、SeaTunnel、OpenMetadata 容器状态。
- MySQL、Doris、Redis 磁盘、连接、慢查询和内存。
- AI 网关延迟、错误率、限流和模型切换情况。
- 调度失败、质量告警、元数据刷新失败和报表加载失败。
- 备份成功率、恢复演练和敏感配置轮换记录。
备份与恢复
| 资产 | 备份内容 | 恢复验证 |
|---|---|---|
| MySQL | 用户、权限、业务建模、质量规则和配置 | 登录、菜单、项目数据 |
| Doris | ODS/DWD/DWS/ADS 数据与建模产物 | 行数、质量规则、看板查询 |
| 对象存储 | 头像、报表资源、上传文件 | 下载与权限校验 |
| 配置 | 环境变量、集成白名单和票据密钥引用 | 不读取明文密钥进行截图 |
| 文档 | Markdown 源文件、图片、导入包与发布清单 | 本地站点和导出文件可打开 |
回滚原则
- 数据库迁移必须提供向前修复或可验证回滚脚本。
- 前后端版本与接口契约应保持兼容，避免只回滚一端。
- 看板、报表和模型发布使用不可变版本，回滚指向历史版本而不是覆盖文件。
- AI 生成的资产支持撤销，但审计记录不得随撤销删除。
常见故障定位
502/504：检查反向代理、后端存活、上游超时和容器日志。不要通过重启所有容器掩盖根因。
401/403：区分会话过期与权限不足。401 重新登录，403 检查角色、菜单、按钮和数据范围。
页面空白或 iframe 不加载：检查一次性票据、安全响应头、X-Frame-Options/CSP 和下游服务状态。
数据为空：检查批次时间、源表行数、质量规则、模型刷新和筛选条件。
AI 无响应：检查模型网关、Key 引用、配额、超时与输入长度；不得在浏览器打印 Key。