Azure Data Factory配置GitHub源码控制后连接异常问题求助

问题背景 #

从 Azure DevOps 迁移到 GitHub，通过基础设施即代码（IaC）更新 Azure Data Factory（ADF）的源码控制连接为 GitHub，使用的 IaC 代码如下：

var repoConfig = {
  repoConfiguration: {
    type: 'FactoryGitHubConfiguration'
    accountName: '<org>'
    repositoryName: '<repo name>'
    collaborationBranch: 'develop'
    rootFolder: '<file path>'
  }
}

var useRepo = (toLower(env) == 'dev01') ? repoConfig : {}

resource ADF 'Microsoft.DataFactory/factories@2018-06-01' = {
  name: adfName
  location: location
  properties: useRepo
  identity: {
    type: 'SystemAssigned'
  }
  tags: appTags
}

操作后出现以下异常：

• 打开 Data Factory Studio 时需登录 GitHub，登录后报错
• GitHub 组织中 AzureDataFactory 应用处于待审批状态，管理员审批通过后
• Studio「管理」>「Git配置」显示正确设置，但仪表板仍持续提示未连接 GitHub，且无法切换分支

排查与修复步骤 #

1. 修正 IaC 语法错误 #

原代码中 repoConfiguration 内的属性缺少逗号分隔，这会导致 Bicep 编译失败或配置未正确应用。修正后的代码：

var repoConfig = {
  repoConfiguration: {
    type: 'FactoryGitHubConfiguration',
    accountName: '<org>',
    repositoryName: '<repo name>',
    collaborationBranch: 'develop',
    rootFolder: '<file path>'
  }
}

同时确认：

• rootFolder 需以 / 开头（如 /ADF），且该路径在 GitHub 仓库中已存在
• env 变量值准确，确保 toLower(env) 返回 dev01，避免 useRepo 为空对象导致配置未注入

2. 验证 GitHub 应用权限 #

• 进入 GitHub 组织「设置」>「应用」>「AzureDataFactory」，确认应用拥有目标仓库的读写权限，以及操作 develop 分支的权限
• 检查授权范围是否覆盖目标仓库，若权限不足，调整后重新保存

3. 重置 Studio 会话与缓存 #

• 使用 Ctrl+F5 强制刷新 Data Factory Studio 页面，清除浏览器缓存后重新登录
• 若有其他 ADF 环境，切换至其他环境再返回目标环境，触发配置重新加载

4. 检查 ADF 后台状态 #

• 在 Azure 门户查看 ADF 实例的「活动日志」，确认 Git 配置更新操作是否成功完成
• 验证门户中 ADF 的「Git 配置」是否与 IaC 定义一致，若不一致，重新部署 IaC

5. 补充可选配置参数 #

若使用 GitHub 应用模式，可在 IaC 中补充 clientId 参数（从 GitHub 应用设置中获取客户端 ID），确保 ADF 与 GitHub 应用的关联完整：

var repoConfig = {
  repoConfiguration: {
    type: 'FactoryGitHubConfiguration',
    accountName: '<org>',
    repositoryName: '<repo name>',
    collaborationBranch: 'develop',
    rootFolder: '<file path>',
    clientId: '<github-app-client-id>'
  }
}

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