拉取请求装饰不显示，最常见的原因有三类：实例侧没有把DevOps平台集成配完整，项目侧没有绑定到正确的仓库配置，流水线侧没有把PR分析参数传给SonarScanner。处理时不要上来就重装或换插件，按实例设置、项目绑定、流水线参数三段把链路对齐，通常一次就能定位到缺口。

　　一、sonarQube拉取请求装饰不显示怎么办

　　装饰不显示先别急着看日志里有没有报错，先确认你用的版本能力范围，再把显示入口、项目绑定、分析触发这三件事核对清楚。很多情况SonarQube已经算完了质量门禁，只是没有成功回写到PR页面。

　　1、先确认版本与授权是否支持PR分析与装饰

　　在SonarQube页面点击【Administration】查看实例信息与版本，再核对当前版本是否具备Pull Request analysis能力；官方文档说明PR分析从Developer Edition起提供，版本不满足时装饰自然不会出现。

　　2、确认DevOps平台侧的显示位置没有被关掉

　　以GitHub为例，装饰摘要会出现在PR的Conversation与Checks区域，Conversation里的摘要可以被关闭；先在PR页面检查【Checks】是否有对应的SonarQube检查结果，再决定是回写失败还是显示被隐藏。

　　3、检查项目是否已绑定到正确的DevOps配置

　　进入具体项目后点击【Project Settings】→【General Settings】，查找【Pull Request Decoration】或【DevOps Platform Integration】相关页面，确认已选中正确的Configuration name并填了对应仓库标识字段，例如GitLab需要Project ID。

　　4、确认实例的Server base URL已设置

　　在实例管理页找到【Administration】→【Configuration】相关入口，检查Server base URL是否配置正确；基础URL缺失或不正确会导致集成功能无法正常生成可回链的装饰内容，表现为分析完成但PR无回写。

　　5、核对流水线是否按PR方式触发分析

　　在CI里查看SonarScanner触发条件，确认PR事件触发时确实执行了分析，而不是只在主分支或普通分支执行；PR装饰依赖一次PR分析运行，单纯跑分支分析不会回写到拉取请求。

　　6、确认PR参数已传入Scanner而不是只传项目Key

　　检查流水线里的Scanner参数，确保包含PR必需参数，例如PR键值与源分支目标分支等；缺少这些参数时，SonarQube会把这次分析当成普通分支分析，自然不会触发装饰回写。

　　二、sonarQube PR装饰凭据在哪里配

　　PR装饰凭据通常不是在项目里随便填一个Token就行，而是要在实例层先建立DevOps平台配置记录，再在项目层引用这个配置名称。不同版本菜单命名可能叫ALM Integrations或DevOps Platform Integrations，但路径逻辑一致，都是先全局后项目。

　　1、在实例层创建平台配置记录

　　用管理员账号登录后点击【Administration】→【Configuration】→【General Settings】，找到【ALM Integrations】或【DevOps Platform Integrations】，选择对应平台页签后点击【Create configuration】创建配置。

　　2、GitLab装饰凭据在GitLab配置里填PAT

　　在GitLab页签创建配置时填写GitLab API地址与GitLab Personal Access Token，Token用于SonarQube通过API回写质量门禁到合并请求；建议使用专用技术账号生成Token并保存到该配置记录。

　　3、Bitbucket Server装饰凭据同样在Bitbucket配置里填PAT

　　在Bitbucket Server配置记录中填写Personal Access Token，文档建议该账号具备对被分析仓库的写入权限以便完成PR装饰回写，避免出现能读能分析但无法评论或写检查结果的情况。

　　4、Azure DevOps凭据在Azure DevOps配置页创建

　　在【ALM Integrations】的Azure DevOps页签点击【Create configuration】创建配置并填入相关信息；项目侧再到【Project Settings】→【General Settings】→【Pull Request Decoration】选择该配置并填写项目与仓库字段。

　　5、GitHub装饰凭据通常通过GitHub App方式接入

　　GitHub集成文档以GitHub App安装与配置为主，完成全局集成后，需要在项目的【Project Settings】→【General Settings】→【Pull Request Decoration】里把该GitHub配置关联到项目，装饰才会生效。

　　6、项目侧只引用配置名不直接存放Token

　　回到项目页面点击【Project Settings】→【General Settings】→【DevOps Platform Integration】或【Pull Request Decoration】，在Configuration name处选择实例层创建的配置记录名称，并补齐平台要求的项目标识字段，例如GitLab Project ID。

　　三、sonarQube PR装饰参数与回写链路怎么核对

　　凭据配好了但仍不显示，下一步就要把回写链路核对到可复现：实例层能否访问平台API，项目层是否绑定到正确仓库，流水线是否以PR分析参数运行。把这三点同时对齐，装饰一般会立刻出现，且后续稳定性更好。

　　1、先在实例层验证配置记录是否可用

　　进入【Administration】→【Configuration】→【General Settings】→【DevOps Platform Integrations】，打开对应配置记录，核对API地址是否可达与Token是否已更新；Token被撤销或权限不足时，分析可能成功但回写失败。

　　2、确认项目是Bound项目或已填写完整的项目级字段

　　如果你是通过导入仓库创建的项目，通常会自动绑定；如果是手工创建的项目，需要在【Project Settings】→【General Settings】里补齐DevOps平台要求的字段，例如GitLab的Project ID与Configuration name。

　　3、核对CI里PR参数是否来自平台事件而不是手填常量

　　在流水线配置中检查PR相关变量来源，确保来自GitHub或GitLab或Azure DevOps的PR事件上下文，再传给Scanner；手填常量容易导致PR键值不匹配，表现为SonarQube里能看到一次分析但PR页面没有对应装饰。

　　4、检查是否把装饰输出发送到了错误的仓库或错误的PR

　　当同一SonarQube实例服务多个仓库时，最常见的误配是项目引用了别的配置名称，或仓库标识字段填错；回写会发往错误目标，当前PR自然看不到。

　　5、确认平台侧允许SonarQube回写检查结果

　　以GitHub为例，装饰会以检查结果方式呈现，若组织策略限制第三方App写检查结果，可能导致装饰缺失；此时应回到平台侧应用权限与仓库权限列表核对授权范围。

　　总结

　　sonarQube拉取请求装饰不显示怎么办，按版本能力、项目绑定、PR分析参数三段排查最省时间，先确认PR分析能力满足，再核对项目级配置与流水线PR参数是否齐全。sonarQube PR装饰凭据在哪里配，通常在实例层【Administration】→【Configuration】→【General Settings】的【ALM Integrations】或【DevOps Platform Integrations】里创建配置记录并保存PAT或App配置，项目侧再引用Configuration name并补齐平台要求的仓库标识字段即可。