🐛 缺陷报告黄金准则

1. 为什么缺陷报告如此重要

缺陷报告是测试工程师最核心的工作交付物。一个糟糕的缺陷报告会让开发耗费数小时才能复现（甚至直接标记为"无法复现"而关闭），而一条优秀的缺陷报告能让开发5分钟内理解并开始修复。

⚠️ 残酷真相在你提交缺陷报告的那一刻，你就已经"不在场"了。开发读报告时，你没有机会在旁边解释。报告必须自给自足。

2. 缺陷报告的七大黄金准则

准则	说明	反例
1. 一个报告一个Bug	不要在一个报告里塞多个问题	"登录有问题，而且头像也不显示"
2. 标题即摘要	标题说清「什么模块+什么现象」	"有个Bug" / "系统报错"
3. 步骤可复现	任何人按步骤操作都能看到同样结果	"点了几下就出错了"
4. 期望vs实际	明确说出你期望的结果和实际看到的结果	只说"不正常"而不说"应该怎样"
5. 附截图/录屏	一张好截图胜过一百个文字描述	纯文字描述一个复杂UI问题
6. 注明环境	版本号、浏览器、操作系统、测试数据	"在浏览器上测的"
7. 合理定级	按严重程度和优先级准确标注	把所有Bug都标为P0/Critical

3. 标准缺陷报告模板

📄 缺陷报告模板

============================================
   [BUG] 订单提交时优惠券金额计算错误
   报告人：张三 | 日期：2026-05-28
============================================

【基本信息】
模块：订单-优惠券
版本：v2.1.0 (build #2847)
环境：Staging (https://staging.example.com)
浏览器：Chrome 125 / macOS 14.5
严重级别：Major (P1)
状态：Open → 指派给：李四（开发）

【标题】（一句话说清问题）
满200减50优惠券在订单金额199元时仍可提交，
但实际未扣减优惠金额

【复现步骤】（编号+精确操作）
前置条件：用户已登录，账户中有一张"满200减50"优惠券
1. 访问首页，搜索任意商品
2. 将商品加入购物车，数量调整为总价 = 199 元
3. 进入购物车页面，点击"去结算"
4. 在结算页面，点击"选择优惠券"
5. 选择"满200减50"优惠券（此时应提示不满足条件）
6. 观察到：系统允许选择该优惠券，且订单总价仍为199元
7. 点击"提交订单"
8. 订单成功创建，应付款金额仍为199元

【期望结果】vs【实际结果】
✅ 期望：系统提示"订单金额不满足该优惠券使用条件"，
        优惠券无法被选中
❌ 实际：优惠券可被选中，但付款时金额未扣减，
        用户未获得任何优惠

【复现频率】
必现（5/5次）

【附件】
- 截图：优惠券选择界面.png（显示199元仍可选满200券）
- 录屏：完整复现过程.mp4（2分15秒）
- 测试数据：使用的账户 test_user_003

【根因推测】（可选，帮助开发定位）
疑似 CouponValidator.validate() 方法中金额判断使用的
是原始商品总价而非优惠后金额，导致门槛判断失效。

【严重级别判定依据】
- 影响范围：所有使用满减优惠券的用户
- 业务影响：优惠券功能形同虚设，可能引发客诉
- 无绕过方案

4. 好报告 vs 差报告对比

❌ 差报告

标题：支付有问题

内容：刚才在支付页面点了几次，有时候能成功有时候不行，感觉有Bug，你们看下。

缺失：步骤、版本、环境、截图、期望结果、频率——全部没有。

✅ 好报告

标题：[支付] 支付宝扫码后页面白屏不跳转，Chrome 125复现

内容：v2.1.0 Staging环境，Chrome 125 / Windows 11。选择支付宝支付→扫码→手机确认付款→PC页面白屏（期望跳转到支付成功页）。必现3/3次。截图已附。

齐全：环境、步骤、期望/实际、频率、附件

5. 严重级别与优先级定义

标签	严重级别	定义	示例
Blocker	P0 - 阻塞	系统无法使用，测试无法继续	登录接口500，所有功能不可用
Critical	P1 - 严重	核心功能不可用，无绕过方案	支付扣款成功但订单未生成
Major	P2 - 主要	功能部分不可用，有绕过方案	导出Excel格式错乱，可手动调整
Minor	P3 - 次要	UI/文案问题，不影响功能	按钮颜色与设计稿不一致
Trivial	P4 - 建议	优化建议，非缺陷	"这个提示语可以更友好"

💡 定级秘籍问自己两个问题：
1. 这个问题会让用户无法完成核心任务吗？→ Blocker/Critical
2. 这个问题有绕过方案吗？→ 有则降一级

6. 缺陷报告自检清单

☐ 标题是否包含模块名 + 现象描述
☐ 一个报告是否只描述一个问题
☐ 复现步骤是否编号且精确（陌生人能否照着操作？）
☐ 是否同时描述了期望结果和实际结果
☐ 是否附上了截图或录屏
☐ 是否标注了版本、环境、浏览器/设备
☐ 严重级别是否有据可依

← 上一页：测试报告编写指南下一页：测试知识沉淀方法 →

🐛 缺陷报告黄金准则 · 写作模板系列