重复缺陷分析记录表模板:含根因判断与预防措施验证
重复缺陷分析记录表以“一次重复缺陷分析”为一行,用表头固定分析范围、重复发生条件、根因判断、预防措施、责任人与验证结果六组字段。下面给出一张可直接复制到文档或表格工具中的空白模板,再逐字段说明填写口径,标出必填与选填,并用一条完整记录示范从根因判断到措施验证的闭环写法。
Table of Contents
要点总览(TL;DR)
- 记录表以“一次重复缺陷分析”为一行,主表固定分析范围、重复发生条件、根因判断、预防措施、责任人、验证结果六组字段,措施明细放在跟踪子表。
- 重复发生条件写成“相同点+时间窗+计数口径”的判断句,例如同一模块、同一触发路径在90天内出现两次及以上,口径在表头统一约定。
- 根因判断分两步:先写直接原因,再追问为何反复出现,每条根因至少附一项证据,只有结论的记录评审时退回补充。
- 记录编号、根因证据、措施责任人、计划完成时间、验证方式与关闭结论属于必填项,空缺统一标注“待补充”并写明责任人与期限。
- 模板按评审中反复出现的填写分歧调整,保留版本号与变更记录,旧记录按原版本归档,便于跨季度对比根因分布。
可复制空白模板:重复缺陷分析记录表
模板分为主表和措施跟踪子表。主表记录一次重复缺陷分析的整体判断,子表拆解每条预防措施的执行与验证状态。复制时保留表头文字,空白行按实际分析条数增删。
主表:重复缺陷分析记录
| 字段 | 填写内容 |
|---|---|
| 记录编号 | |
| 分析日期 | |
| 分析人 / 参与人 | |
| 关联缺陷编号 | |
| 所属项目 / 版本 | |
| 功能模块 | |
| 缺陷现象摘要 | |
| 首次发生时间 | |
| 重复发生次数 | |
| 重复发生条件(判定口径) | |
| 历史处理记录 | |
| 直接原因 | |
| 根本原因 | |
| 根因分类 | |
| 根因证据 | |
| 预防措施概述 | |
| 措施责任人 | |
| 计划完成时间 | |
| 验证方式 | |
| 验证人 | |
| 验证结果 | |
| 关闭结论 |
子表:预防措施跟踪
| 措施编号 | 对应记录编号 | 措施类型 | 具体动作 | 责任人 | 计划完成时间 | 实际完成时间 | 验证方式 | 验证人 | 验证结果 | 状态 |
|---|---|---|---|---|---|---|---|---|---|---|
主表适合在评审会上逐行核对结论,子表适合日常跟踪措施进度。两张表的记录编号与措施编号需要互相对应,避免措施脱离分析记录单独流转。
字段说明:每个字段填什么、怎么判断
同一张表由不同人填写时,差异通常出在重复发生条件和根因判断两处。字段说明的作用是把判断口径写清楚,让填写结果可以横向比较。
| 字段 | 填写口径 | 判断依据 |
|---|---|---|
| 记录编号 | 按团队约定规则编号,如“RD-年份-序号” | 唯一即可,便于与缺陷单互相引用 |
| 关联缺陷编号 | 列出本次分析涉及的全部缺陷单号 | 至少包含首次缺陷与最近一次重复缺陷 |
| 所属项目 / 版本 | 写明缺陷出现的项目与版本范围 | 跨版本重复时全部列出 |
| 功能模块 | 填写缺陷所在的功能或服务模块 | 与缺陷单中的模块字段保持一致 |
| 缺陷现象摘要 | 用一两句话描述可观察到的错误表现 | 写现象,不写推测原因 |
| 重复发生次数 | 填写统计口径下的发生次数 | 与表头注明的统计时间窗对应 |
| 重复发生条件 | 写明判定为“重复”的具体条件 | 见下方判定写法 |
| 历史处理记录 | 简述此前每次修复的动作与结果 | 说明为何此前修复未阻止再次发生 |
| 直接原因 | 导致本次缺陷出现的直接技术原因 | 可由日志、代码或配置直接印证 |
| 根本原因 | 使直接原因得以产生并反复出现的深层原因 | 需有证据支撑,不能只写结论 |
| 根因分类 | 从团队约定的分类中选择,如需求理解、设计缺陷、编码实现、测试覆盖、配置环境、流程协作 | 一条记录选一个主分类,可另注次要分类 |
| 根因证据 | 列出支撑根因判断的材料 | 日志片段、复现步骤、代码或配置变更记录、评审记录 |
| 预防措施概述 | 概括主表对应的措施方向 | 与子表措施条目对应 |
| 验证方式 | 写明如何确认措施有效 | 如补充用例回归、代码扫描、监控观察周期 |
| 验证结果 | 填写通过、未通过或待观察 | 附验证时间与观察范围 |
| 关闭结论 | 写明关闭、继续跟踪或升级处理 | 与验证结果一致 |
重复发生条件的判定写法
重复发生条件要写成可核对的判断句,包含三个要素:相同点、时间窗、计数口径。例如“同一功能模块、同一触发路径下的同类错误,在最近两个版本或90天内出现两次及以上”。相同点可以是同一模块、同一触发路径、同一错误码或同一类用户操作;时间窗和计数口径由团队在表头统一约定,不同项目可以使用不同数值,但同一项目内应保持一致。条件写得越具体,评审时越容易判断某条缺陷是否应纳入本表。
根因判断的分类与证据要求
根因判断建议分两步:先写直接原因,再追问为什么这个直接原因会反复出现。直接原因回答“错在哪里”,根本原因回答“为什么没有被提前发现或阻止”。例如直接原因是空值未处理,根本原因可能是接口约定缺少边界值说明,且测试用例未覆盖该输入。根因分类用于后续统计哪类问题反复出现,分类项不宜过多,五到八项足够。每条根因至少附一项证据,证据可以是日志、复现步骤、代码或配置变更记录、需求评审记录。只有结论没有证据的记录,评审时应退回补充。
预防措施的可执行写法
预防措施写成“动作 + 对象 + 完成标志”的形式,避免“加强测试”“提高意识”这类无法验证的表述。措施类型可分为代码规范、测试补充、需求或设计澄清、流程调整、监控告警五类。每条措施单独占子表一行,指定一名责任人,给出计划完成时间。一条分析记录可以对应多条措施,但每条措施都要能独立验证。
验证结果与结论字段
验证结果记录三件事:用什么方式验证、由谁验证、观察了多长时间或多大范围。结论字段与验证结果保持对应:验证通过且观察期内未再出现,填“关闭”;措施已完成但观察期未满,填“继续跟踪”;措施无法落地或重复再次出现,填“升级处理”并说明下一步。
必填与选填:哪些字段不能空
必填字段保证记录可评审、可追溯;条件必填字段在特定情形下才需要填写;选填字段用于补充信息。空缺时统一标注“待补充”并写明补充责任人和期限,避免留白被误读为“无问题”。
| 类别 | 字段 | 说明 |
|---|---|---|
| 必填 | 记录编号、分析日期、分析人、关联缺陷编号、所属项目 / 版本、功能模块、缺陷现象摘要、重复发生次数、重复发生条件、直接原因、根本原因、根因分类、根因证据、预防措施概述、措施责任人、计划完成时间、验证方式、验证人、验证结果、关闭结论 | 缺少任一项,记录不具备评审条件 |
| 条件必填 | 历史处理记录 | 重复发生两次以上时必须填写,说明此前修复情况 |
| 条件必填 | 实际完成时间 | 措施状态为“已完成”或“已验证”时必填 |
| 条件必填 | 升级说明 | 关闭结论为“升级处理”时必填 |
| 选填 | 参与人、次要根因分类、备注 | 用于补充评审参与情况和分类细节 |
空缺标注规则建议统一为三种写法:“待补充”表示尚未取得信息,需注明责任人与期限;“不适用”表示该字段在本条记录中确实无需填写,需一句话说明理由;“无”仅用于确认某项内容确实不存在,例如历史处理记录为空。三种写法混用会让评审人难以判断记录的真实状态。
填写示例:一条完整的重复缺陷分析记录
以下为演示情景,用于说明字段之间的对应关系,数据为虚构。
| 字段 | 填写内容 |
|---|---|
| 记录编号 | RD-2025-014 |
| 分析日期 | 2025-03-12 |
| 分析人 / 参与人 | 测试负责人李某;参与人:开发张某、产品王某 |
| 关联缺陷编号 | BUG-2317、BUG-2489、BUG-2603 |
| 所属项目 / 版本 | 订单中心,V3.2 与 V3.3 |
| 功能模块 | 优惠券核销 |
| 缺陷现象摘要 | 优惠券在跨天零点前后核销时,偶发提示“券已失效”,实际仍在有效期内 |
| 首次发生时间 | 2025-01-18 |
| 重复发生次数 | 3 次(90 天内) |
| 重复发生条件 | 同一模块、同一触发路径(零点前后核销),90 天内出现 2 次及以上即纳入分析 |
| 历史处理记录 | BUG-2317 修复了单条券的时间判断;BUG-2489 调整了缓存刷新频率;两次修复均未覆盖批量券的时间边界 |
| 直接原因 | 核销校验读取的是缓存中的过期时间,缓存刷新与数据库时间存在秒级偏差 |
| 根本原因 | 券有效期的时间边界未在接口约定中明确,缓存与数据库的时间口径不一致,测试用例只覆盖了正常时段核销 |
| 根因分类 | 设计缺陷(主);测试覆盖不足(次) |
| 根因证据 | BUG-2603 日志片段;复现步骤记录;接口文档中有效期字段无边界说明;用例清单中无零点场景 |
| 预防措施概述 | 统一时间口径并补充边界用例,共 3 条措施,见子表 |
| 措施责任人 | 张某(措施 1、2);李某(措施 3) |
| 计划完成时间 | 2025-03-31 |
| 验证方式 | 补充用例回归 + 连续两个版本零点时段监控观察 |
| 验证人 | 李某 |
| 验证结果 | 通过:用例回归全部通过,V3.4、V3.5 观察期内未再出现同类缺陷 |
| 关闭结论 | 关闭 |
对应子表记录:
| 措施编号 | 措施类型 | 具体动作 | 责任人 | 计划完成时间 | 验证结果 | 状态 |
|---|---|---|---|---|---|---|
| M-014-1 | 设计澄清 | 在接口文档中补充有效期字段的时间口径与边界说明,评审通过后发布 | 张某 | 2025-03-20 | 通过 | 已验证 |
| M-014-2 | 代码规范 | 核销校验统一读取数据库时间,缓存仅作展示用途,提交代码评审 | 张某 | 2025-03-25 | 通过 | 已验证 |
| M-014-3 | 测试补充 | 新增零点前后、跨时区、批量券三类边界用例,纳入回归清单 | 李某 | 2025-03-31 | 通过 | 已验证 |
这条示例展示了闭环的关键:历史处理记录说明前两次修复为何失效,根因证据支撑根本原因的判断,三条措施分别对应设计、代码和测试三个层面,验证结果与关闭结论一致。
调整与维护:让记录表长期可用
模板需要在团队实际使用中调整,调整的依据是评审时反复出现的填写分歧和跟踪断点,而不是字段越多越好。
按团队情况增删字段的取舍
增字段的判断标准是:该信息是否会影响根因判断或措施验证。例如团队缺陷单中已有模块和版本信息,记录表可以只保留引用编号,减少重复填写;如果团队经常出现跨团队协作导致的重复缺陷,可以增加“协作方”字段。删字段时注意保留可追溯性,关联缺陷编号和根因证据不建议删除。字段名称一旦确定,主表、子表和字段说明应同步修改。
评审与归档节奏
建议按固定节奏评审:重复缺陷分析记录在分析完成后一周内提交评审,评审会核对根因证据是否充分、措施是否可验证;措施跟踪子表按周或按迭代更新状态;关闭结论在观察期结束后确认。归档时按项目或季度整理,保留原始记录与措施验证材料,便于后续统计哪类根因反复出现。
模板版本与变更记录
模板本身应有版本号和变更记录,写明每次增删字段的原因、生效日期和适用范围。旧记录按原版本保留,不追溯改写,新记录使用新版本。这样在跨季度对比时,能区分是问题变化还是口径变化。
与缺陷跟踪流程的衔接
记录表不应脱离缺陷跟踪流程单独存在。缺陷单中标记为重复的条目,应能关联到对应的分析记录编号;措施完成后,缺陷单状态与分析记录的验证结果同步更新。若团队使用 ONES,可将分析记录放在 ONES Wiki 文档中,并通过文档关联任务与缺陷工作项建立对应关系;ONES Project 支持缺陷跟踪管理,可一键提交 Bug 至对应项目或迭代,并统计缺陷状态分布,便于在措施验证阶段核对同类缺陷是否再次出现。具体字段配置和状态流需按团队实际流程设置。
常见问题
重复缺陷的判定口径由谁定,不同项目可以用不同时间窗吗?
判定口径由团队在模板表头统一约定,通常由质量或测试负责人牵头,与开发负责人确认后生效。不同项目可以使用不同的时间窗和计数阈值,例如有的项目取90天两次,有的取两个版本内两次,前提是同一项目内部保持一致。跨项目汇总时,需要在统计说明中注明各自口径,避免把口径差异误读为质量差异。
根因判断写到什么程度算充分,评审时如何快速判断?
可用的判断标准是:直接原因能被日志、代码或配置直接印证;根本原因能解释“为什么这个直接原因会反复出现”,并至少附一项证据,如日志片段、复现步骤、接口文档或评审记录。评审时先看证据是否与结论对应,再看根因分类是否只选了一个主分类。若记录只写“开发疏忽”“测试不足”这类结论而无证据,应退回补充后再评审。
预防措施验证未通过,或者观察期内同类缺陷再次出现,记录表怎么处理?
验证未通过时,子表中该措施状态改为未通过,补充未通过原因,并新增一条替代措施重新指定责任人与完成时间。观察期内同类缺陷再次出现时,主表关闭结论填“升级处理”,在升级说明中写明下一步动作,例如扩大分析范围、调整根因分类或提交更高层级评审。原记录保留,不覆盖改写,新增的重复缺陷可关联到同一记录编号下继续跟踪。
团队已有缺陷单,记录表里的关联缺陷编号和模块信息还要重复填吗?
可以只保留引用编号,减少重复录入。缺陷单中已有项目、版本、模块和现象描述时,记录表填写关联缺陷编号即可,评审时按编号回查。需要保留的是缺陷单里没有、但影响根因判断的信息,例如历史处理记录、根因证据和措施验证结果。若团队使用 ONES,可将分析记录放在 ONES Wiki 文档中,并通过文档关联任务与缺陷工作项建立对应关系,减少两处信息不一致。
记录表需要多久评审一次,归档后还能修改吗?
建议分析完成后一周内提交评审,措施跟踪子表按周或按迭代更新状态,关闭结论在观察期结束后确认。归档后原记录不追溯改写,若发现填写错误或需要补充证据,以备注或补充记录的形式追加,并注明追加日期与追加人。这样跨季度统计根因分布时,能区分是问题本身变化还是记录口径变化。



