调试与性能工程陷阱与实战避坑指南¶
1. 调试子系统核心工程陷阱与规避¶
陷阱 1：海森堡效应（Heisenbug）——加打印后故障消失¶
- 现象：系统在高并发下偶发竞态死锁，加入
printk()后暂时无法复现；移除打印后故障重新出现。 - 可能原因：打印引入锁、缓冲处理或控制台 I/O，改变了并发执行时序。延迟取决于内核版本、控制台配置和输出量，需在当前环境中测量。
- 规范规避：使用非侵入式硬件 Trace（ARM CoreSight ETM / STM）或内核内存环形缓冲区跟踪（
trace_printk/ eBPF），避免在并发敏感区引入同步 I/O。
陷阱 2：JTAG Halt 导致看门狗硬复位¶
- 现象：使用 JTAG 调试器命中断点后，刚停顿几秒钟，系统突然被硬件复位重启，调试连接断开。
- 根因：CPU 核心被 Halt 暂停，但芯片内部的硬件看门狗（Watchdog）定时器仍在独立硬件计数，倒计时归零后触发全局复位。
- 规范规避：在调试初始化脚本中配置 CTI / CTM 交叉触发，或者在看门狗控制寄存器中置位
PAUSE_IN_DEBUG，使得 CPU Halt 时看门狗自动暂停计数。
2. 性能工程核心陷阱与规避¶
陷阱 1：只看平均延迟（Average Latency）忽视长尾抖动（P99 Jitter）¶
- 现象：网络或数据库压测平均响应时间为 1.2ms（看似优异），但在实际生产中客户端频繁发生超时重试。
- 根因：由于垃圾回收（GC）、DDR 刷新、Page Fault 或关中断，有 $1\%$ 的请求延迟高达 $500\text{ms}$，拉垮整体业务体验。
- 检查方法：同时查看平均值、P95 / P99 / P999 等分位数与延迟分布，按业务的超时和吞吐要求确定验收指标。
陷阱 2：基准测试未预热与频率浮动干扰¶
- 现象：两次运行相同的性能测试代码，得出相反的优化结论。
- 根因：未进行预热（冷启动 Cache 命中率低、页表未建立）；CPU 调频策略（governor）处于动态节能模式，两次测试时核心工作主频不同。
- 检查方法：记录 CPU 调频策略和实际频率，按测试目标决定是否固定频率、是否预热。比较补丁时保持条件一致；评估真实业务时，还要包含实际使用的 DVFS 策略。
performance governor 请求策略限制内的最高频率，并不等于硬件实际主频在整个测试期间恒定。参见 Linux CPUFreq 文档。
3. 内存与总线性能陷阱与规避¶
陷阱 1：跨通道 DDR 交织配置错误导致单通道饱和¶
- 现象：系统总带宽利用率仅有 50%，但特定处理流发生严重掉帧与丢包。
- 根因：地址交织粒度（Interleaving Granularity）过大（如 64KB），导致大块连续数据全部落在同一 DDR Channel 上，另一 Channel 处于空闲。
- 规范规避：根据 SoC 互联特性配置 128B / 256B 细粒度交织，实现多通道流量均衡。
4. 调试与性能分析速查清单¶
- [ ] 发生死锁时优先收集全核 PC、调用栈及当前持有自旋锁状态。
- [ ] 区分硬件中断屏蔽与软件死循环，测量关中断最长延迟。
- [ ] 补丁对比时，保持调频策略、温度和预热条件一致。
- [ ] 业务压测时，记录实际主频与 DVFS 变化，区分冷启动和稳态表现。
- [ ] 跨核高频并发共享数据结构是否已使用
perf c2c排查过伪共享（False Sharing）？