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