在代码静态分析过程中,告警规则决定了QAC检查哪些问题,以及这些问题以什么级别显示。项目开发阶段,团队通常会根据代码规范、质量要求以及维护习惯调整规则配置,让检查结果更加符合当前项目情况。实际使用QAC时,修改告警规则后没有产生变化的情况比较常见,例如新增规则后没有提示、调整严重等级后结果不变、不同项目使用相同规则却得到不同结果等。这些问题通常和规则保存、项目关联、分析任务读取配置等环节有关。
一、QAC怎么设置告警规则
QAC告警规则设置需要结合项目使用的检查标准进行调整。开始配置前,需要确认当前项目采用的规则集以及分析环境。
1、查看当前项目规则配置
设置告警规则前,需要先确认项目正在使用哪些规则。
①、打开【QAC】。
②、进入【项目管理】。
③、选择目标项目。
④、打开【规则配置】。
⑤、查看当前启用规则。
⑥、进入规则管理页面。
不同项目可能使用不同规则组合,修改前先确认目标项目,可以避免调整错误配置。
2、调整规则启用状态
部分检查项需要根据项目要求开启或者关闭。
①、进入【规则列表】。
②、选择目标规则。
③、查看规则状态。
④、修改启用选项。
⑤、保存规则配置。
⑥、返回规则列表确认。
如果规则处于关闭状态,后续分析过程中不会生成对应告警。
3、修改告警级别
QAC中的问题等级可以根据项目管理要求进行调整。
①、打开【规则详情】。
②、查看当前告警等级。
③、选择新的等级设置。
④、确认修改内容。
⑤、保存规则变化。
调整等级后,需要重新执行分析,已有报告中的问题等级不会自动变化。
4、配置项目使用的规则集
规则调整完成后,还需要确认项目实际调用的配置。
①、打开【项目设置】。
②、进入【分析配置】。
③、查看当前规则集。
④、关联目标规则。
⑤、保存项目配置。
如果项目仍然绑定旧规则集,检查结果不会受到新的规则影响。
5、重新执行规则检查
完成规则调整后,需要通过新的分析任务验证配置。
①、打开【分析任务】。
②、选择目标项目。
③、启动代码检查。
④、等待分析结束。
⑤、查看最新告警结果。
新的分析结果可以反映当前规则配置是否已经应用。
二、QAC告警规则调整后没有生效如何检查
规则修改后结果没有变化时,需要按照实际表现进行排查。重点查看规则是否保存、项目是否加载以及分析任务是否读取新的配置。
1、确认规则修改已经保存
有时规则页面中的修改只是临时状态,没有正式写入配置。
①、打开【规则配置】。
②、查看修改后的规则。
③、确认告警等级。
④、检查保存状态。
⑤、重新进入页面确认。
如果重新打开后配置恢复原样,说明修改没有成功保存。
2、检查项目关联规则是否正确
项目使用的规则集不一致时,调整后的规则不会参与检查。
①、打开【项目设置】。
②、进入【分析配置】。
③、查看当前规则集。
④、确认关联规则。
⑤、更新项目配置。
⑥、重新执行分析。
多个项目共用配置时,需要确认修改的是当前项目实际使用的规则。
3、确认是否生成新的分析结果
QAC不会自动修改已经生成的检查报告。
①、打开【分析记录】。
②、查看最近检查时间。
③、确认分析任务。
④、重新运行检查。
⑤、查看新的结果文件。
如果查看的是旧报告,即使规则已经修改,也不会看到变化。
4、检查规则适用条件
部分规则只有满足特定条件时才会触发。
①、打开【规则详情】。
②、查看规则说明。
③、检查适用范围。
④、确认代码类型。
⑤、调整规则条件。
规则启用并不代表所有代码都会触发,需要结合检测条件判断。
5、查看分析日志
当规则配置没有问题,但结果仍然异常时,可以检查分析过程。
①、打开【分析日志】。
②、查看规则加载信息。
③、检查异常记录。
④、定位分析阶段。
⑤、重新执行检查。
日志中的加载信息可以确认QAC是否读取到了新的规则配置。
三、QAC告警规则调整后如何整理检查记录
告警规则经过调整后,除了确认检查结果变化,还需要整理配置记录。项目长期维护过程中,规则会根据开发规范变化进行修改,保留调整过程方便后续查看。
1、记录规则调整内容
①、打开【规则配置】。
②、查看当前规则状态。
③、记录修改项目。
④、保存配置文件。
⑤、整理调整记录。
2、对比调整前后结果
①、进入【分析结果】。
②、查看历史检查记录。
③、比较告警数量。
④、检查问题变化。
⑤、记录分析差异。
3、维护项目规则信息
①、打开【项目设置】。
②、查看规则关联情况。
③、整理分析参数。
④、保存项目信息。
⑤、完成配置维护。
总结
QAC告警规则调整后,检查结果是否变化不仅取决于规则本身,还和项目配置、分析任务以及代码情况有关。遇到规则没有生效的问题,可以先确认修改是否保存,再检查项目加载的规则集和新的分析记录。完成调整后,保留规则变化和检查结果信息,能够方便后续查看项目质量变化。合理维护QAC规则配置,可以让静态分析流程更加符合项目开发要求。