Azure Pipeline无法检出Git子模块问题求助

核心问题排查与修复 #

1. 核对子模块名称与仓库路径 #

从报错信息看，流水线尝试克隆的是shared_backend，但你提供的.gitmodules定义的是shared_components，这说明：

• 主仓库的.gitmodules可能存在多个子模块配置，或是有拼写错误
• 必须确保子模块的仓库URL、路径与实际存在的仓库完全匹配，避免名称或路径错误

2. 修正子模块URL的相对路径问题 #

你使用的相对路径../shared_components在本地克隆时有效，但Azure DevOps流水线环境中，Git无法正确解析相对路径为有效的HTTPS仓库地址。需将子模块URL改为完整的Azure DevOps仓库地址：

[submodule "submodules/shared_components"]
    path = submodules/shared_components
    url = https://dev.azure.com/myorg/MyProject/_git/shared_components

修改后提交.gitmodules文件到主仓库，重新触发流水线。

3. 确认Build Service账户的权限 #

确保项目级Build Service账户（格式：[组织名]\[项目名] Build Service ([组织名])）被添加到子模块仓库的「读者」或更高权限组中。不要仅依赖组织级的Build Service权限，必须明确为项目级账户授权。

4. 优化流水线Checkout配置 #

调整checkout步骤参数，确保persistCredentials正确生效，同时关闭不必要的Git LFS（如果未使用）：

steps:
- checkout: self
  displayName: 'Checkout'
  submodules: recursive
  persistCredentials: true
  lfs: false

5. 手动注入认证令牌（备选） #

如果上述方法无效，可在流水线中手动配置子模块认证：

- script: |
    # 覆盖子模块URL为完整地址
    git config --file .gitmodules submodule.submodules/shared_components.url https://dev.azure.com/myorg/MyProject/_git/shared_components
    git submodule sync
    # 注入系统访问令牌进行认证
    git -c http.extraheader="AUTHORIZATION: bearer $(System.AccessToken)" submodule update --init --recursive
  displayName: '初始化子模块并认证'

同时需在流水线设置中开启「允许脚本访问OAuth令牌」选项。

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