uvm_report_catcher 正则匹配速查:message/ID 过滤、降级与抑制实战
更新时间:2026-10-06。本文是「集成电路大类 · 数字验证」的速查篇,解决一个回归维护期天天碰到的问题:DUT 或 VIP 在特定场景下会打出一批「预期内」的 WARNING/ERROR(比如故意注入协议错误时 VIP 的报错),不打补丁它们会淹没真问题,打补丁又怕误杀。uvm_report_catcher 就是这道闸门,而它的匹配条件几乎总是正则。消息分级的基础见 SystemVerilog report 严重级别,catcher 降级的完整方法学见 UVM report catcher 降级实战,本篇是可放桌面的速查卡。
本文要回答的问题
- catcher 里怎么用正则匹配 message 和 ID?匹配接口是什么?
- 按 ID 匹配和按 message 正则匹配,工程上怎么选?
- demote(降级)和 suppress(抑制)差在哪,各适合什么场景?
- 多个 catcher 同时注册时顺序怎么算?
一、最小可用模板
catcher 是继承 uvm_report_catcher、重写 catch() 回调的类,catch() 返回 CAUGHT(消息已被处理,不再上报)或 THROW(放行给下一个 catcher)。正则匹配用 uvm_re_match():返回 0 表示匹配成功(注意是 C 风格的 0=成功,不是 1),返回值大于 0 表示不匹配,小于 0 表示正则本身编译错误。
class vip_err_demoter extends uvm_report_catcher;
virtual function action_e catch();
// 按 ID 精确匹配 + 按 message 正则匹配,双条件
if (get_id() == "VIP_PROTOCOL" &&
get_severity() == UVM_ERROR &&
uvm_re_match(".*rx timeout.*", get_message()) == 0) begin
set_severity(UVM_INFO); // demote:降级仍可见
set_action(get_action() | UVM_DISPLAY);
return THROW; // 放行,以 INFO 身份上报
end
return THROW;
endfunction
endclass注册位置决定作用域:uvm_report_cb::add(null, catcher) 全局注册;uvm_report_cb::add(my_agent, catcher) 只拦指定组件发出的消息。预期错误注入场景的惯例是在 sequence/test 里「用前注册、用完 remove」——uvm_report_cb::add(null, c) 起手,场景结束 uvm_report_cb::delete(null, c) 收尾,catcher 的生命周期跟着场景走,绝不裸挂全回归。
还有一个和 catcher 经常搞混的机制顺带分清:set_report_severity_id_override() 是「按 ID 静态改级」的注册表式接口,不需要写类、不支持正则、也不分场景——适合「某 ID 的消息在整个 test 里永久降级」的简单诉求;catcher 是带逻辑、带正则、带生命周期管理的完整方案。能用 override 一行解决的别写 catcher 类,需要 message 级细分或场景化开关的别硬用 override——选型错位写出来的代码两头不讨好。
二、ID 匹配 vs message 正则:取舍表
| 维度 | 按 ID 匹配 | 按 message 正则 |
|---|---|---|
| 稳定性 | 高(ID 是代码常量) | 低(文案一改就失配) |
| 粒度 | 粗(同 ID 消息全中) | 细(可区分同 ID 不同情形) |
| 移植性 | 跨语言/工具稳 | 正则方言有差异(POSIX 扩展) |
| 适用 | VIP 自有 ID 体系 | 第三方组件无 ID 纪律、或需细分 |
工程口径一句话:先按 ID 粗筛,再用 message 正则细分。ID 不存在或不可靠(很多老 VIP 用 "" 或全大写泛 ID)时才退到纯正则。写正则的三条军规:锚定子串用 .*xxx.* 而不是全串匹配(前缀后缀的实例名、时间戳会坑你);正则里的特殊字符([]().)在消息文案常见,该转义就转义;把正则字符串提成 localparam string 集中放类头,失配时改一处。uvm_re_match 匹配的是整个字符串必须满足正则,所以不锚定首尾就要显式加 .*。
方言问题也要心里有数:uvm_re_match 底层走 DPI 调 POSIX 正则(多数仿真器是扩展正则 ERE),不是 Perl 方言——\d、\w、非贪婪 .*? 这些写法不一定支持,数字写 [0-9]、空白写 [ \t] 最稳。常用模式备查:
| 需求 | 模式 |
|---|---|
| 含某关键词 | .*timeout.* |
| 多关键词之一 | `.*(timeout |
| 含数字编号 | .*channel [0-9]+ failed.* |
| 消息开头匹配 | ^FATAL:.* |
| 排除某词(间接法) | 先匹配再 uvm_re_match 反查,或用两个 catcher 串联 |
最后一行展开说:ERE 没有负向前瞻(negative lookahead),「匹配 A 但不含 B」用纯正则写不出来。实战做法是串联两个 catcher:第一个拦「含 B」的子集原样 THROW 放行,第二个再拦「含 A」的大集合做降级——利用 LIFO 顺序让特例先走,通用兜底在后。这招比试图手写巨型正则可靠得多,也便于审计每条规则的命中数。
三、完整生命周期示例:注册、命中计数与回收
把「用前注册、用完回收、命中可观测」三条纪律落到一段可直接抄的代码:
class err_inj_catcher extends uvm_report_catcher;
localparam string PAT = ".*(rx timeout|parity mismatch).*";
int unsigned hit_cnt = 0;
virtual function action_e catch();
if (get_id() == "VIP_PROTOCOL" &&
get_severity() inside {UVM_ERROR, UVM_WARNING} &&
uvm_re_match(PAT, get_message()) == 0) begin
hit_cnt++;
set_severity(UVM_INFO);
return THROW;
end
return THROW;
endfunction
endclass
// 在 sequence body 或 test 中:
task run_scenario();
err_inj_catcher c = new();
uvm_report_cb::add(null, c); // 注册
inject_error_traffic(); // 注入场景
uvm_report_cb::delete(null, c); // 回收
if (c.hit_cnt == 0)
`uvm_error("TEST", "catcher 未命中:正则失配或场景未触发")
`uvm_info("TEST", $sformatf("catcher 命中 %0d 次", c.hit_cnt), UVM_LOW)
endtask两个细节。其一,severity 条件用 inside {UVM_ERROR, UVM_WARNING} 而不是等值判断——同一 VIP 在不同配置下同一事件可能报 WARNING 也可能报 ERROR,等值写死会漏拦一半。其二,「命中计数 ≥1」的结尾检查不是锦上添花:正则写错、ID 拼错、场景没真正触发,这三种失败模式全都表现为「catcher 静默拦了零条」,没有这个检查,catcher 失效能潜伏好几个版本。命中次数还可以接 covergroup 的 coverpoint,把「每场风景 catcher 命中数分布」纳入回归看板,次数异常波动(突然变零或暴涨)本身就是信号。
注册作用域再补一刀:add(null, c) 是全局拦截,简单但影响面大;若知道消息来源组件,add(uvm_test_top.env.my_vip_agent, c) 精确到组件,其他组件的同名消息不受影响——多 agent 的 VIP 环境强烈建议精确注册,全局 catcher 拦错人的事故在共享 VIP 的 SoC 项目里几乎每家都踩过。
四、demote 与 suppress:一张图分清

demote 把 ERROR 降为 INFO/WARNING,消息仍出现在日志里,只是不再触发 $error 计数和回归失败判定——适合「这个场景下确实会发生、但我想留痕审计」的消息。suppress(return CAUGHT 或清 action)让消息彻底消失,适合「海量噪声确认无害」(如 VIP 在每个复位都打的提示)。默认选 demote;suppress 必须有配套的证据链——比如被抑制消息同时有 covergroup 计数,确认「抑制发生的次数」本身可观测,否则某天 DUT 行为真变了你也无从知晓。回归平台的失败判定也要对齐:多数脚本按日志里的 UVM_ERROR/UVM_FATAL 计数判 pass/fail,demote 之后这些消息以 INFO 身份留存,不会误触判定;但若平台还扫关键词(比如扫 "error" 字样的宽松规则),demote 后的文案里残留的关键词照样会误报,对接平台规则时把这一条核对掉。
多 catcher 的顺序:后注册的先执行(栈式,LIFO)。catch() 返回 CAUGHT 即短路,后续 catcher 不再被调。纪律:特异性强的 catcher(细分正则)后注册先拦,通用兜底的先注册垫底;每条被 CAUGHT 的消息在 catcher 里用 uvm_info 自报一次「我拦了它」,审计可追溯。
五、常见坑清单
- 返回值记反:
uvm_re_match(...) == 0才是匹配,写成== 1永远拦不到,回归静默失效——这是最高频坑,没有之一。 - 忘了 remove:场景结束没 delete catcher,后续场景的预期报错被继续降级,回归假绿。成对写在 sequence 的 body 首尾,或用 RAII 式的 wrapper。
- 只拦 severity 不看 ID:
if (get_severity()==UVM_ERROR)一刀切降级,真 bug 全被压。任何 catcher 都必须带 ID 或 message 条件。 - CAUGHT 后无痕迹:抑制消息不留任何日志/计数,审计归零。
- 正则不匹配时无告警:catcher 期望拦 N 条但一条没拦到(正则写错或场景没触发),要有「本场景 catcher 命中计数 ≥1」的结尾检查,否则 catcher 形同虚设。
- 改 message 不改 severity:有些团队想在 catcher 里顺便改写消息文案(去掉实例路径便于日志聚合),只调
set_message()而忘了原 severity/action 组合,文案变了但分级逻辑照旧,日志聚合规则反而失配——改文案时连同 action 一起显式重设。 - UVM 版本差异:UVM 1.1 与 1.2 的 catcher 注册接口(
uvm_report_cbvsuvm_report_cb_iter的遍历行为)有细节差异,跨版本移植 catcher 库时先跑一个「故意拦一条」的冒烟用例确认链路通。 - 在 catcher 里打
uvm_error:catch 回调内再发 error 级消息会递归进 catcher 链,写审计日志一律用uvm_info,且 verbosity 设高避免刷屏。
这一篇在知识体系里的位置
本篇是 UVM report catcher 降级实战 的正则速查版,消息分级基础见 SystemVerilog report 严重级别,日志侧配套见 UVM report server 定制 和 UVM verbosity 控制。
总结
uvm_report_catcher 正则速查的要点是:匹配用 uvm_re_match 且返回 0 才命中,先按 ID 粗筛再按 message 正则细分,默认 demote 留痕、suppress 必须配命中计数,注册跟随场景生命周期成对 add/delete,多 catcher 后注册先执行——守住「只拦预期内、命中可观测」两条底线,catcher 才是降噪利器而非埋雷工具。