Jenkins GitHub Checks Plugin发布失败，提示Resource not accessible by integration

问题背景 #

使用自托管Jenkins的Multibranch Pipeline部署GitHub Checks Plugin时，遇到如下报错：

[GitHub Checks] Failed Publishing GitHub checks: org.kohsuke.github.HttpException: {"message":"Resource not accessible by integration","documentation_url":"https://docs.github.com/rest/checks/runs#create-a-check-run"}

但GitHub Branch Source Plugin可正常工作，能收到continuous-integration/jenkins/pr-merge — This commit looks good的通知。

解决方案 #

核心原因是GitHub App的权限配置不足——Branch Source仅需基础仓库权限，而Checks Plugin需要额外的检查运行写入权限，按以下步骤修复：

• 更新GitHub App权限

  1. 登录GitHub，进入对应GitHub App的设置页面
  2. 找到「Permissions & events」模块，在「Repository permissions」下：
     • 将「Checks」权限设置为Read and write
     • 确保「Contents」权限至少为Read（Branch Source正常工作则已满足）
  3. 保存权限后，重新将该GitHub App安装到目标仓库/组织，使权限变更生效

• 验证Jenkins凭据与配置

  1. 确认Jenkins中配置的GitHub App凭据对应已更新权限的App
  2. 检查Multibranch Pipeline的GitHub Checks相关设置，确保选择了正确的凭据，无配置遗漏

• 检查仓库访问权限

  1. 若为私有仓库，确认GitHub App已正确安装到该仓库（而非仅安装到组织但未勾选仓库）
  2. 针对PR场景，若PR来自fork仓库，需确保GitHub App有访问源分支的权限（同仓库PR无需额外配置）

• 插件兼容性与生效

  1. 确认GitHub Checks Plugin与GitHub Branch Source Plugin使用最新稳定版，版本兼容
  2. 重启Jenkins，确保所有配置变更生效

内容的提问来源于stack exchange，提问作者Rolando