Cloudflare Workers 连不上 GitHub？教你几招快速排查

最近在网上看到不少朋友吐槽，说自己的 Cloudflare Workers 突然无法读取 GitHub 仓库信息了，甚至连通过 Git 仓库 URL 克隆代码都失败。明明之前授权得好好的，怎么突然就“断联”了呢？

遇到这种问题确实很搞心态，尤其是当你急着部署代码的时候。别慌，这通常是几个常见原因导致的。今天咱们就来聊聊如何系统性地排查并解决这个问题。

论坛求助帖中展示的连接失败界面

1. 检查 GitHub 应用的授权状态

首先，最常见的问题其实出在“过期的授权”上。

在 GitHub 设置中管理和撤销 OAuth 应用授权

很多人在初次连接 Cloudflare 和 GitHub 时，都做过 OAuth 授权。但这个权限是有时效性的，或者在某些情况下会被撤销。如果你发现 Cloudflare 读不到你的仓库列表，大概率是授权失效了。

解决步骤：

• 登录你的 GitHub 账号，点击右上角头像，选择 Settings（设置）。
• 在左侧菜单栏找到 Applications（应用程序），然后点击 OAuth Apps。
• 在列表里找到 Cloudflare 相关的授权条目，查看状态是否正常。如果不确定，直接点击 Revoke（撤销）。
• 回到 Cloudflare Dashboard，重新进行一次 GitHub 账号连接。这会刷新你的 Token 权限，通常能解决“读不到仓库”的问题。

2. 警惕网络环境的“锅”

有时候，问题本身不在 Cloudflare 或 GitHub，而在于你当前的网络环境。

在国内访问 GitHub，连接不稳是常态。如果你部署的 Worker 逻辑需要去 fetch GitHub 的 API 内容，或者你本地的电脑在推拉代码时中间经过了某些“代理”服务，可能会因为 DNS 污染或者 IP 被风控而导致连接超时。

解决思路：

• 如果你是在本地操作克隆失败，尝试切换一下代理节点，或者改用 SSH 方式替代 HTTPS 进行克隆。
• 如果是 Cloudflare Workers 在运行时报错（比如 522 或者 520 错误），那可能是 Cloudflare 的边缘节点到 GitHub 之间的链路出现了短暂的抖动。这种情况下，通常稍等几分钟再试即可，毕竟这是巨头之间的通信，恢复速度通常很快。

3. Personal Access Token (PAT) 是否挂了

有些高级玩家不是直接用 OAuth 授权，而是配置了 GitHub 的 Personal Access Token（个人访问令牌）来进行仓库操作。如果你的构建脚本或 Worker 代码里硬编码了 Token，请务必检查两点：

• Token 过期了吗？ GitHub 现在默认生成的 Token 都是有时效性的（比如 30 天或 90 天）。如果过期了，Cloudflare 拿着废票自然进不去。
• 权限范围够不够？ 这一点经常被忽视。如果你的操作涉及读写仓库内容，但 Token 只勾选了 repo:status 而没勾选完整的 repo 权限，克隆和写入操作都会被无情拒绝。

建议： 去开发者设置里重新生成一个永不过期（或者选择最长时效）的 Token，并把权限范围拉满，然后更新到 Cloudflare 的环境变量或 Secrets 里。

4. 是不是触发了 API 速率限制？

GitHub 的 API 对未认证请求有严格的速率限制（每小时 60 次），即便是认证请求，上限也是有的。如果你的 Worker 是一个公开服务，被大量用户访问，瞬间耗尽 API 配额，后续的请求就会被 GitHub 拒绝，表现出来的症状就是“无法读取信息”。

排查方法：

• 查看报错信息的 HTTP 状态码。如果是 403 Forbidden 并且提示 API rate limit exceeded，那就说明是被限流了。
• 解决方案： 必须在请求头带上有效的 Authorization Token 提升限额，或者在代码层面增加缓存机制（比如 Cloudflare KV），不要每次请求都去 GitHub 源站拉数据。

写在最后

遇到 Cloudflare 连不上 GitHub，先别急着去论坛发帖喊“炸了”。按照上面这四步——重授权、查网络、换 Token、看限流——90% 的问题都能自己解决。技术圈里，很多所谓的“平台故障”，其实都是配置小细节在作祟。

如果你试了以上所有方法依然不行，那可能就是极小概率的平台链路故障了，这时候去官方社区查看 Status 页面或者提交工单才是正解。希望这篇笔记能帮到大家，少走弯路！