更换Azure环境后Databricks Notebook关联新GitHub仓库报404错误求助

• 网络与环境配置校验 #

  • 确认新仓库的可见性，若为私有仓库，检查Azure Databricks工作区所在虚拟网络的NSG、防火墙、私有端点出站规则，确认是否允许访问新仓库对应的GitHub IP段：旧公开仓库可能默认符合现有出站规则，私有新仓库容易出现网络拦截
  • 若当前Azure环境使用的是GitHub Enterprise Server而非公网GitHub，确认新仓库归属的实例域名已经加入Databricks工作区的允许访问列表

• GitHub PAT权限二次校验 #

  • 若使用的是细粒度PAT（Fine-grained PAT），确认已将新仓库加入该PAT的授权仓库列表，且单独授予了Contents读写权限：旧仓库可能提前加入了授权列表，新仓库未配置会触发权限类404
  • 本地验证权限有效性：在本地终端执行git clone <新仓库HTTPS地址>，使用配置的PAT作为密码进行认证，确认可以正常克隆，排除PAT本身对新仓库的权限问题

• Databricks 侧配置排查 #

  • 确认新仓库的名称、路径中无特殊字符、空格或非ASCII字符，低版本Azure Databricks对特殊字符路径解析异常会触发404
  • 企业级工作区需确认新仓库所属的GitHub账户/组织在工作区的Git提供商白名单内，部分企业会限制仅允许指定组织的仓库接入
  • 清除原有Git凭据缓存后重试：进入用户设置>Git集成，删除已保存的GitHub凭据，重新输入凭据后再关联新仓库，避免旧缓存干扰

• GitHub 仓库侧配置排查 #

  • 确认新仓库已完成初始化，至少存在1个有效分支（如main分支），完全空的仓库会导致Databricks拉取分支信息时返回404
  • 若新仓库开启了默认分支保护规则，首次关联时可指定一个非保护的测试分支验证，避免默认分支禁止写入导致的关联失败

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