# 关键教训（必读）

WesPy 活动埋点测试的核心教训，来自真实项目的实战经验。

---

## 教训1: 必须实际触发验证，不能只看代码（Critical）

**案例**: reward_num字段硬编码为2026

**问题**:
- 代码看起来有字段，但值是硬编码的
- 不实际触发就发现不了字段值错误

**测试方法**:
1. 实际触发埋点（完成任务、领取奖励等）
2. 抓包查看实际上报的JSON数据
3. 数数平台查询验证字段值正确性

**影响**: 🔴 Critical - 数据错误，报表失真

---

## 教训2: 埋点可能多次上报，需要验证上报次数（Warning）

**案例**: hunt_room_win 一次触发上报2次

**问题**:
- 一个业务操作可能打点到多个用户（房主+top用户）
- 不实际测试就不知道上报次数

**测试方法**:
1. 触发一次操作
2. 数数平台查询，统计上报条数
3. 验证是否符合预期（1条 or 2条）

**影响**: ⚠️ Warning - 数据量不符预期

---

## 教训3: Widget埋点需要确认功能是否启用

**案例**: 测试用例要求测试抽奖，但活动未配置抽奖Widget

**问题**:
- 测试用例列出的功能，活动配置中可能没有启用
- 不查配置就不知道哪些功能要测

**测试方法**:
1. 查询活动配置，确认启用了哪些Widget
2. 只测试已启用的功能
3. 未启用的功能标记为"不适用"

**影响**: ⚠️ Warning - 测试覆盖率不准确

---

## 核心原则（必记）

记住这5条原则，确保测试质量：

1. ✅ **必须实际触发，不能只看代码** - 代码看起来对，不代表实际运行正确
2. ✅ **必须抓包验证** - 确认埋点真的上报了，字段值真的正确
3. ✅ **必须数数平台验证** - 确认数据能查到，且值正确
4. ✅ **必须多场景测试** - 边界场景、异常场景、不同维度都要测
5. ✅ **必须记录测试结果** - 截图、SQL、问题描述都要详细记录

---

[← 返回主文档](../SKILL.md)