Bug 报告模板¶

使用此模板记录和追踪验证过程中发现的 Bug

1. 基本信息¶

1.1 状态¶

1.2 分类¶

2. 问题描述¶

2.1 现象描述¶

[详细描述 Bug 的现象，包括： - 观察到的错误行为 - 与预期行为的差异 - 错误发生的频率（必现/偶发）]

示例：

在连续突发传输测试中，当突发长度超过 16 拍时，AXI 总线在第 17 拍出现数据错误，WRONG 信号被拉高。此问题必现。

2.2 影响范围¶

• 功能正确性 - 影响核心功能
• 性能 - 影响系统性能
• 功耗 - 影响功耗指标
• 面积 - 影响综合面积
• 时序 - 影响时序收敛
• 其他 - [具体描述]

影响说明： [详细描述 Bug 对项目的影响]

3. 复现步骤¶

3.1 测试环境¶

3.2 复现步骤¶

1. 步骤 1： [详细描述第一步操作]

   1 2	// 代码示例 reg_write(BASE + 0x00, 0x12345678);

2. 步骤 2： [详细描述第二步操作]

   1 2	// 启动操作 reg_set_bit(BASE + 0x04, 0);

3. 步骤 3： [详细描述第三步操作]

   1	等待 done 信号拉高

4. 步骤 4： [观察结果]

   1 2	预期：data_out = 0x87654321 实际：data_out = 0x87654300 // 低 8 位错误

3.3 波形截图¶

[插入关键波形截图，标注问题点]

4. 根因分析¶

4.1 分析过程¶

[描述如何定位到根因的]

示例：

通过波形分析发现，在数据输出的最后 8 位时，状态机提前进入了 DONE 状态，导致数据截断。

4.2 根本原因¶

[清晰的根因描述]

示例：

状态机 FSM 在计数到 15 时（16 拍完成），比较逻辑错误地使用了 >= 而不是 >，导致在第 16 拍时就提前结束。

4.3 影响分析¶

• 直接影响： [描述]
• 潜在影响： [描述]
• 关联模块： [是否有其他模块受此问题影响]

5. 修复方案¶

5.1 修复描述¶

[描述具体的修复方案]

示例：

修改状态机比较逻辑，将 count >= 15 改为 count > 15

5.2 修改文件¶

5.3 代码变更¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

// 修改前
always @(posedge clk) begin
    if (count >= 15) begin
        state <= DONE;
    end
end

// 修改后
always @(posedge clk) begin
    if (count > 15) begin
        state <= DONE;
    end
end

5.4 回归测试¶

• 修复后原测试通过
• 相关测试回归通过
• 全量回归测试通过

6. 验证结果¶

6.1 验证状态¶

6.2 验证数据¶

6.3 验证人¶

7. 预防措施¶

7.1 流程改进¶

• 更新设计规范
• 更新验证计划
• 添加新的检查项
• 更新代码审查清单

7.2 技术措施¶

• 添加新的断言
• 增加覆盖率检查点
• 完善测试用例

7.3 经验总结¶

[从此 Bug 中学到的经验和教训]

8. 时间线¶

9. 相关文档¶

10. 审批关闭¶

模板版本：1.0 | 最后更新：2026-05-03