GitLab CI作业中Git子模块无法正常使用问题咨询

看起来你遇到了GitLab CI里子模块拉取失败的问题——明明配置了子模块策略，作业执行时却找不到database_schema目录，还报了cd命令的错误。结合你给出的复现步骤和现象，我整理了几个排查方向和解决办法：

1. 检查子模块URL的适配性与权限 #

你在.gitmodules里用的是相对路径../../nss/database_schema.git，这个路径在本地开发环境可能没问题，但CI runner的工作目录结构和本地完全不同，相对路径大概率会失效。建议换成绝对URL：

• 如果是GitLab内部项目，用SSH格式：git@gitlab.example.com:nss/database_schema.git（需要给CI runner配置能访问该子模块的SSH密钥）
• 或者用HTTPS格式并带上CI作业令牌：https://gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.example.com/nss/database_schema.git，这样CI可以直接用内置的令牌授权访问子模块

2. 替换自动子模块策略为手动拉取 #

虽然你设置了GIT_SUBMODULE_STRATEGY: recursive，但偶尔会因为runner版本或配置问题导致自动策略不生效。可以在before_script里手动执行子模块同步和更新，这样能看到更详细的拉取日志：

variables:
  # 可先注释自动策略，改用手动命令
  # GIT_SUBMODULE_STRATEGY: recursive
rspec:
  stage: test
  before_script:
    - git submodule sync --recursive
    - git submodule update --init --recursive
    - ls
    - cd database_schema

手动执行的好处是，如果子模块拉取失败，你能在CI日志里直接看到具体的错误信息（比如权限拒绝、URL不存在）。

3. 确认本地主仓库的子模块状态是否正确 #

有时候手动创建.gitmodules文件但没实际执行git submodule add命令，会导致主仓库里没有子模块的引用记录。本地要确保：

• 执行过git submodule add ../../nss/database_schema.git database_schema（对应你的路径）
• 已经把.gitmodules文件和主仓库里的子模块引用推送到远程仓库

4. 仔细查看CI作业的完整日志 #

你提到能看到“Upati...”开头的日志，这应该是CI尝试更新子模块的日志段。一定要仔细看这部分的完整内容，有没有隐藏的报错——比如“Permission denied”、“Repository not found”这类信息，这些才是子模块拉取失败的核心原因。

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