Jenkins多分支流水线中访问私有GitHub仓库问题求助

我之前也碰到过几乎一模一样的情况，折腾了好一阵才搞定，给你几个实打实的排查和解决方向：

1. 核对凭据的类型与权限范围 #

• 分支源配置里的凭据类型要选对：如果用的是GitHub个人访问令牌（PAT），得选「Username with password」类型——用户名填你的GitHub账号名，密码栏填PAT（注意这和克隆用的SSH密钥不是一回事，GitHub源的API调用依赖PAT而非SSH密钥）。
• 确认PAT的权限：必须勾选repo（全仓库权限）和admin:repo_hook（钩子管理）这两项，少一个都可能导致API拉取不到仓库列表。你可以去GitHub的「Settings > Developer settings > Personal access tokens」里编辑令牌，补全权限后再试。

2. 手动验证GitHub API的访问权限 #

• 在Jenkins服务器上用curl测试API调用，比如执行：

  curl -u 你的GitHub用户名:你的PAT https://api.github.com/user/repos
  

  如果能返回你的私有仓库列表，说明API权限没问题；要是返回403或空数组，要么是PAT权限不够，要么是该用户确实没有仓库访问权限（哪怕你说有完全权限，也再确认下用户是不是仓库的所有者/协作者）。
• 更新GitHub相关插件：旧版本的GitHub插件或GitHub Branch Source插件可能存在API兼容问题，去「Manage Jenkins > Plugins」里把这两个插件更到最新版，很多时候更新插件就能解决这类奇怪的识别问题。

3. 检查分支源配置的细节 #

• 「Owner」字段要填准确的GitHub用户名/组织名：有时候大小写不一致也会出问题（虽然GitHub本身不区分大小写，但插件可能有严格校验），比如你GitHub用户名是Rycochet，别填成rycochet。
• 先取消「Filter by name」选项：如果不小心勾了这个又没填过滤规则，会直接把所有仓库过滤掉，导致下拉为空。先关掉这个选项，再看仓库列表会不会出现。

4. 排查网络与代理设置 #

• 如果Jenkins在代理环境下，要确保「Manage Jenkins > System Configuration」里的代理配置正确，而且api.github.com没有被排除在代理之外。有时候代理会拦截API请求，导致Jenkins拉取不到仓库数据。
• 验证服务器能连通api.github.com：用ping api.github.com或者telnet api.github.com 443测试网络，确认没有防火墙或安全组阻止了请求。

5. 重置Jenkins的凭据缓存 #

Jenkins有时候会缓存旧的凭据信息，导致新配置的凭据不生效：

1. 去「Manage Jenkins > Manage Credentials」里删掉旧的GitHub凭据，重新添加一次。
2. 重启Jenkins服务，让缓存完全清空，再重新配置分支源。

我当时就是因为PAT少了admin:repo_hook权限，补全之后立刻就看到仓库列表了，你可以按这些步骤挨个排查试试。

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