Jenkins Pipeline无法连接GitHub私有仓库 创建失败问题排查

报错Invalid scan credentials when using anonymous access和Personal Access Token（PAT）权限无关，是Blue Ocean插件在Docker版Jenkins环境下的已知凭证绑定缺陷：创建Pipeline向导中输入的GitHub PAT仅保存在Blue Ocean的临时会话上下文，没有同步到多分支项目的仓库扫描配置项，扫描动作触发时无有效凭证，默认降级为匿名用户访问私有仓库，进而触发读不到分支、误报仓库不存在Jenkinsfile的连锁错误。
该问题可稳定复现：使用官方Docker镜像全新部署Jenkins、安装默认推荐插件+Blue Ocean套件、尝试为GitHub私有仓库创建多分支Pipeline时100%触发。

前置操作：配置全局可用的GitHub凭证 #

不要在Blue Ocean创建向导中直接输入PAT，提前在Jenkins全局凭证库录入有效凭证：

• 进入 Manage Jenkins > Credentials > System > Global credentials (unrestricted)，点击添加凭证
• 凭证类型选择Username with password
  • 用户名：填写GitHub账号的用户ID（即个人主页路径对应的ID，不要填绑定邮箱）
  • 密码：填写GitHub生成的PAT，权限无需全开，勾选repo全项、admin:repo_hook读取权限即可满足Pipeline拉取、构建触发需求
  • 描述字段填写github-scan-cred方便后续识别，保存即可

修复已创建失败的Pipeline #

• 打开创建失败的Pipeline任务，进入Configure配置页
• 找到Branch Sources配置区块，可看到Credentials下拉选项默认选中- none -，这就是扫描走匿名访问的直接原因
• 下拉选择刚才创建的全局GitHub凭证，其余配置保持不变
• 保存配置后点击Scan Repository Log触发扫描，即可正常拉取分支列表、识别仓库内的Jenkinsfile，构建流程恢复正常

后续新建Pipeline避坑 #

使用Blue Ocean新建私有仓库Pipeline时，认证步骤直接选择已经提前配置好的全局凭证，不要在向导中临时输入新的PAT，即可绕过凭证不同步的bug。

如果完成上述操作仍报错，逐一检查以下项：

• 进入Jenkins运行的Docker容器，执行curl https://api.github.com确认容器网络可正常访问GitHub接口，无超时、证书校验失败问题
• 如果仓库归属GitHub企业组织，检查所用PAT是否完成对应组织的SSO授权
• 不要使用GitHub App类型的凭证作为多分支扫描凭证，用户名+PAT类型的凭证在Blue Ocean链路下兼容性最好

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