Jenkins多分支流水线GitHub凭证验证失败问题求助

我之前配置Jenkins多分支流水线时也碰到过几乎一模一样的问题，明明全局验证PAT是有效的，但任务就是报认证错误。结合你的情况，大概率是这几个原因之一：

1. 多分支任务未关联正确的GitHub服务器配置 #

你已经在Jenkins全局配置里添加了https://api.github.com的GitHub服务器并验证了PAT，但多分支流水线任务可能没指定使用这个配置。去任务的配置页面，找到「GitHub服务器」选项，确认是不是选中了你刚才配置的那个服务器，而不是默认的「None」或者其他无效选项——很多人容易忽略这一步，导致任务用了默认的未认证请求。

2. PAT权限不足以支撑多分支流水线需求 #

全局验证PAT只是检查能否访问用户信息，但多分支流水线需要扫描仓库分支、读取PR信息等操作，对PAT的权限要求更高：

• 如果是私有仓库，需要给PAT分配repo权限；
• 如果是公开仓库，至少要有public_repo权限；
• 如果你需要自动触发流水线（比如分支推送时），还得加上admin:repo_hook权限。
  另外，也要确认PAT有没有过期、有没有被意外撤销。

3. 凭证类型选择错误 #

GitHub PAT对应的Jenkins凭证类型必须是Secret text，而不是「Username with password」或者其他类型。如果你选错了类型，哪怕PAT内容完全正确，Jenkins也会用错误的方式发送认证请求，导致失败。

4. 网络/代理环境不一致 #

全局验证PAT时的网络环境，和多分支任务运行节点的网络环境可能不一样：

• 比如Jenkins全局配置了代理，但任务运行的节点没配置；
• 或者节点的防火墙/安全组限制了对api.github.com的访问。
  可以在任务运行的Jenkins节点上，手动执行命令测试：

curl https://api.github.com/user -H "Authorization: token 你的PAT内容"

如果返回用户信息，说明网络没问题；如果还是报认证错误，那就是PAT本身的问题；如果连请求都发不出去，就是网络/代理的问题。

5. GitHub相关插件版本不兼容 #

如果你的Jenkins版本比较新，但GitHub Branch Source Plugin、GitHub Plugin这些插件版本太旧，可能会出现API兼容问题，导致认证流程出错。建议把这些插件更新到最新稳定版，然后重启Jenkins再试。

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