SonarQube中文网站 > 最新资讯 > SonarQube项目通知怎么订阅 SonarQube项目通知支持哪些分析事件
教程中心分类
SonarQube项目通知怎么订阅 SonarQube项目通知支持哪些分析事件
发布时间:2026/11/16 14:08:26

  流水线显示SonarQube分析已提交,团队却没收到邮件,这不一定是通知坏了。项目邮件按事件发送:质量门禁状态变化、新增问题、服务器后台任务失败,都有各自的订阅项。一次分析顺利完成,但门禁仍是通过,也没产生符合通知条件的新问题,就可能没有邮件。以下以SonarQube Server为例,说明项目通知在哪里订阅,以及怎样判断一次运行是否应当触发通知。

  一、SonarQube项目通知怎么订阅

 

  项目邮件是在个人账号里设置的。几位开发人员关注同一个项目时,可以各自选择想接收的事件,无须把所有人的订阅设成一样。

 

  1、把目标项目加到个人通知列表

 

  ①点击页面右上角的账号图标,依次进入【My Account】→【Notifications】。

 

  ②在【Notifications per project】区域点击【Add project】,输入项目名称的前几个字符,从候选项中选中目标项目,再点【Add】。

 

  ③展开刚加入的项目,在【Email】列勾选要订阅的事件。以后只想停收其中一类邮件,回到同一项目取消对应勾选即可。

 

  如果测试和生产环境各有一个同名项目,添加前先核对当前登录的实例,并在项目页确认项目键。名字相同,分析报告却可能提交到了另一处。

 

  2、按职责勾选事件

 

  个人待办和团队共用的质量信号可以分开订阅。比如维护流水线的人更关心分析结果是否处理成功,开发人员则可能只想知道有哪些新问题分给了自己。

 

  ①想跟进门禁由通过变为不通过,或由不通过恢复为通过,在目标项目下勾选【Quality gate changes】。

 

  ②负责查看分析处理异常时,勾选【Background tasks in failure】;只跟进分配给自己的新问题时,勾选【My new issues】。

 

  ③若收信范围比预期更广,回到【Notifications】,同时检查【Overall notifications】。项目订阅和全局订阅分别配置,排查时两处都要看。

 

  二、SonarQube项目通知支持哪些分析事件

 

  以SonarQube Server 2025.6的项目邮件选项为例,可以按后台任务、门禁和问题动态来理解。旧版本的部分选项名称会有不同,以当前实例的通知页为准。

 

  1、门禁变化与后台任务失败分开看

 

  分析报告可以处理成功,质量门禁仍可能不通过。例如,新代码覆盖率低于设定值,服务端算出了结果,后台任务也正常结束,但门禁从通过变成了不通过。

 

  ①查看【Quality gate changes】时,对照项目概览里的前后状态。连续两次都不通过,不能仅凭第二次仍为红色,就判定会再发一封状态变化邮件。

 

  ②查看【Background tasks in failure】时,核对服务端的【Background Tasks】记录。分析报告提交后,若服务器处理任务失败,应检查这项订阅。

  2、区分项目新增问题与分配给自己的新问题

 

  ①需要跟进该项目中由自己代码引入的新问题时,勾选【New issues】,并结合实际提交核对结果。

 

  ②只想知道有哪些新问题被分配给当前账号时,勾选【My new issues】,再到【Issues】中查看负责人。

 

  问题由谁引入、当前由谁处理,有时是两个人。收到其中一类通知,并不表示另一类也满足发送条件。

 

  3、查看问题和安全热点的处置动态

 

  ①想跟进其他用户对自己名下问题或安全热点所做的变更,在项目下勾选【Changes in issues/hotspots assigned to me】。

 

  ②需要留意项目中被标记为误报或接受的问题,勾选【Issues resolved as false positive or accepted】。核对邮件时,对照【Issues】中的实际处置状态和项目范围。

 

  三、SonarQube项目没收到通知怎么排查

 

  可以先拿一轮有明确结果的运行来核对。若这轮确实发生了所订阅的事件,再去查邮件投递;如果运行根本没到服务端,检查邮箱也找不到原因。

 

  1、对照流水线日志和服务器任务

 

  ①打开CI的【扫描步骤日志】,确认扫描器是否成功上传报告。若在编译、认证或上传阶段就退出,继续查该步骤的失败日志。

 

  ②报告已上传时,请有权限的人员在SonarQube中打开项目的【Background Tasks】,核对对应任务及处理状态。

 

  ③后台任务成功时,回到项目【Overview】,对照本轮与上一轮门禁状态,确认所订阅的事件是否发生。

 

  2、确认事件发生后再查邮件

 

  ①在【My Account】→【Notifications】中确认订阅的是目标项目,并核对对应事件在【Email】列是否勾选。

 

  ②核对个人账号的邮件地址,请实例管理员检查服务端的【SMTP】设置并发送测试邮件。如果测试邮件已发出,再查收件箱过滤规则或邮件隔离记录。

 

  测试邮件能到,只能说明邮件通道可用。复核项目订阅时,还应找一次明确满足条件的事件,例如门禁确实从通过变成不通过,再核对是否收到对应邮件。

 

  3、每次分析结束都要留记录时,改看Webhook

 

  有的团队要把每轮结果送到构建看板,即便门禁始终是通过,也要记一条。这类需求适合用Webhook接收事件,再由接收端决定怎样展示或发送通知。

 

  ①由有权限的人员进入【Project Settings】→【Webhooks】,为项目配置接收地址。

 

  ②运行一次分析,在【Webhooks】的投递记录中核对接收结果。若扫描器在上传前就失败,则继续由CI记录并报告该次失败。

  总结

 

  项目通知越贴近日常分工,收到邮件后越容易知道该做什么。开发人员可以关心自己接到的新问题,维护人员可以关心后台处理失败,质量负责人则可能只想知道门禁什么时候变了。团队若习惯用邮件判断“这一轮有没有跑”,可以把运行记录留在流水线或看板里。这样,安静的收件箱只表示没有收到所订阅的事件,不会被误解成没人跑分析。

176 5129 0128