cfc/tests/E2E-TEST-GUIDE.md

E2E 测试运行指南

环境准备

1. 启动后端服务

cd /app/cfc/cfc-backend
mvn spring-boot:run
# 后端服务运行在 http://localhost:9082

2. 启动前端 H5 服务

cd /app/cfc/cfc-frontend
npm run dev:h5
# 前端 H5 服务运行在 http://localhost:8080

3. 安装 Playwright 依赖

cd /app/cfc/tests
npm install
npx playwright install

运行测试

运行所有 E2E 测试

cd /app/cfc/tests
npm run test:e2e

运行指定流程测试

# 运行测评订单流程
npx playwright test tests/e2e/assessment-order-flow.spec.js

# 运行家庭成员管理流程
npx playwright test tests/e2e/family-member-management.spec.js

# 运行心愿兑换流程
npx playwright test tests/e2e/wish-exchange-flow.spec.js

调试模式（有 UI）

npm run test:e2e:headed

查看测试报告

npm run test:report
# 报告保存在 playwright-report/ 目录

测试文件列表

文件	描述	场景数
assessment-order-flow.spec.js	测评订单全流程	7
family-member-management.spec.js	家庭成员管理	9
wish-exchange-flow.spec.js	心愿兑换审批	9
planner-bind-invite.spec.js	规划师绑定邀请	7
growth-record-sync.spec.js	成长记录同步	6
energy-system.spec.js	能量系统收支	6
product-purchase.spec.js	商品购买支付	9
daily-checkin-streak.spec.js	连续签到奖励	8

注意事项

1. 页面路由：测试使用 uni-app hash 路由格式（如 /#/pages/assessment/apply）
2. 元素选择器：测试使用 CSS class 选择器，需要与前端实现匹配
3. 测试数据：部分测试需要预设数据（如已绑定的家庭成员、已有的订单等）
4. 超时设置：复杂操作已设置较长的超时时间

测试覆盖的里程碑

每个测试文件都包含以下里程碑验证：

• Milestone-1: 流程启动成功（如创建订单、添加成员）
• Milestone-2: 核心操作成功（如支付、定价）
• Milestone-3: 状态变更成功
• Milestone-4: 数据关联/更新成功
• Milestone-5: 完整流程成功

故障排查

问题：页面元素找不到

原因：前端页面结构可能与测试选择器不匹配

解决：

1. 检查前端页面的实际 class 名称
2. 更新测试中的选择器
3. 使用 page.waitForSelector() 等待元素出现

问题：API 请求超时

原因：后端服务未启动或响应慢

解决：

1. 确保后端服务运行在 9082 端口
2. 增加 timeout 配置

问题：测试数据不存在

原因：依赖的数据未初始化

解决：

1. 在测试前手动创建所需数据
2. 或在测试中使用 setup 钩子准备数据