Coverity中的组件映射可以按照源码文件路径把同一代码库划分成多个组件，让缺陷按照模块、团队或代码区域进行归类。处理“Coverity怎么配置组件映射，Coverity组件映射后缺陷归属不正确如何调整”时，重点要检查组件规则、正则匹配顺序以及Stream实际关联的组件映射。规则能够匹配文件并不代表归属一定正确，多个规则同时命中时，优先级尤其重要。

　　一、Coverity怎么配置组件映射

　　组件映射通常由多个Component组成，每个组件再通过File Rules定义负责哪些源码文件。Coverity Connect会自动创建Default组件映射，也可以新建独立映射，用于不同项目或代码组织方式。

　　1、创建组件映射

　　①登录Coverity Connect，进入【Configuration】→【Component Maps】。

　　②单击【Add】，创建新的组件映射。

　　③填写映射名称，并根据项目需要补充说明。

　　④如果已有结构相近的映射，可以使用【Duplicate】复制后修改，减少重复配置。

　　⑤选中新建的组件映射，再单击【Add】创建具体Component。

　　⑥按照项目模块填写组件名称，例如core、driver、network或third_party。

　　组件映射更适合按照稳定的代码边界设计，不建议直接按照某一次缺陷列表临时划分，否则代码目录调整后很容易再次出现归属混乱。

　　2、为组件配置文件规则

　　Coverity使用文件规则匹配代码路径，并将对应文件及其中检测到的问题映射到指定组件。官方示例使用正则表达式匹配目录或特定后缀文件。

　　①选中需要设置的Component，进入【File Rules】。

　　②单击【Insert Rule】，添加新的文件匹配规则。

　　③根据实际代码路径填写正则表达式，例如/driver/.*可以覆盖driver目录下的文件。

　　④需要进一步限制文件类型时，在路径规则中加入扩展名条件。

　　⑤在Components选择区域，将该规则分配给对应组件。

　　⑥先观察配置界面的匹配结果，确认目标文件已经进入预期组件。

　　规则尽量围绕完整目录边界编写。只使用include、src等过于宽泛的内容，可能把其他模块中的同名目录一起匹配进去。Coverity官方示例也会加入更完整的上级目录，用于避免匹配到无关的include目录。

　　3、把组件映射关联到Stream

　　组件规则建立完成后，还要把对应组件映射分配给实际提交分析结果的Stream，否则该Stream不会按照新的规则完成组件划分。

　　①进入【Configuration】→【Projects&Streams】。

　　②找到实际接收分析结果的Stream。

　　③检查当前关联的Component Map。

　　④选择刚完成配置的组件映射。

　　⑤保存修改后返回缺陷视图，检查组件信息。

　　⑥项目存在多个Stream时，逐个核对，不要只修改其中一个。

　　二、Coverity组件映射后缺陷归属不正确如何调整

　　组件映射已经生效，但部分缺陷进入错误组件，通常意味着同一个文件同时满足多个规则，或者正则表达式实际覆盖范围与预期不同。此时不应直接修改缺陷本身，而应先定位对应源码文件到底命中了哪条规则。

　　1、检查规则匹配范围

　　①打开归属错误的缺陷，记录缺陷对应的源码文件完整路径。

　　②进入当前Stream使用的组件映射，打开【File Rules】。

　　③逐条对照规则，检查该文件可以匹配哪些表达式。

　　④发现规则范围过大时，加入更明确的上级目录或文件后缀。

　　⑤规则范围过窄时，检查目录层级、斜杠位置和正则表达式是否写错。

　　⑥修改后重新观察配置区域中的文件映射结果。

　　例如本来只希望匹配某个模块下的头文件，却直接使用宽泛的.h规则，就可能把多个目录中的头文件同时纳入同一组件。

　　2、调整重叠规则的优先顺序

　　这是组件归属异常中非常关键的一项。Coverity官方明确说明，一个文件如果同时匹配多个组件规则，会按照列表从上到下分配给最先匹配到的组件。

　　①找到同时能够命中目标文件的几条规则。

　　②把范围更具体的规则移动到靠前位置。

　　③把用于兜底的大范围规则放到后面。

　　④使用上下移动按钮重新排列规则。

　　⑤检查配置区域中的文件归属变化。

　　⑥确认结果正确后单击【Done】应用修改。

　　例如/driver/network/.*和/driver/.*同时存在时，前者通常应该排在后者之前，否则network目录可能先被更宽泛的driver规则接走。

　　3、检查Stream是否用了错误映射

　　①打开出现问题的缺陷所在Stream。

　　②进入项目和Stream配置，查看当前Component Map名称。

　　③与刚才修改的组件映射进行比较。

　　④如果Stream仍关联旧映射，将其切换到正确版本。

　　⑤多个分支使用不同Stream时分别检查。

　　⑥复制过Stream的项目也要复核，因为复制的Stream会继续关联原来的组件映射。

　　如果问题表现为“组件正确，但负责人不对”，还要单独检查Component中的【Default Owner】以及Coverity的自动负责人分配规则。组件归属与缺陷负责人属于不同配置层面，不宜通过修改文件规则解决人员分配问题。

　　三、怎样避免组件映射后续再次混乱

　　组件规则稳定后，维护重点应从“修正单个缺陷”转向“验证规则边界”。项目增加目录、第三方代码或新分支时，都可能改变原有匹配结果。

　　1、建立组件规则检查方法

　　①为每个组件选择几条具有代表性的源码路径。

　　②同时准备容易发生重叠的边界路径，例如公共include、common和third_party目录。

　　③调整规则后先检查这些路径的组件归属。

　　④把具体规则放在前面，通用规则和兜底规则放在后面。

　　⑤代码目录结构改变后，同步检查组件映射，而不是等缺陷归错后再处理。

　　⑥多个Stream共用同一组件映射时，统一确认变更会影响哪些分析结果。

　　Coverity本身允许在最终应用组件规则之前查看配置变化带来的结果，因此规则调整后应先检查影响范围，再正式提交。

　　总结

　　“Coverity怎么配置组件映射，Coverity组件映射后缺陷归属不正确如何调整”的关键，是让File Rules准确对应代码目录，并正确处理规则重叠和Stream关联。出现缺陷归错组件时，应从文件完整路径开始检查，尤其注意Coverity按照从上到下的规则顺序选择首个匹配组件这一机制。把具体规则前置、通用规则后置，并在代码结构变化后及时复核，可以明显减少后续归属偏差。希望本文对大家整理Coverity缺陷组件有所帮助，如果在组件映射配置、规则优先级或缺陷归属调整中还有疑问，欢迎联系咨询。