Gitlab CI基于Debian12镜像（Git2.39.2）执行Git命令失败求助

问题现象 #

1. 执行git submodule update --init时返回错误：

HEAD is now at * Merge branch '' into *
fatal: unable to create threaded lstat: Operation not permitted
fatal: Unable to checkout '' in submodule path '*'

2. Composer执行时出现错误：

Executing command (/builds/dev/*): 'git' 'branch' '-a' '--no-color' '--no-abbrev' '-v'
In Process.php line 356:

[Symfony\Component\Process\Exception\RuntimeException]
Unable to launch a new process.

已尝试常规子模块权限方案但未解决。

排查与解决步骤 #

1. 检查GitLab Runner权限配置 #

• 若用Docker executor，修改config.toml中Runner配置，添加privileged = true后重启Runner，部分文件系统线程操作需要特权权限。
• 若用Shell executor，执行sudo chown -R runner-user:runner-group /builds，确保运行Runner的用户对构建目录有完整读写执行权限。

2. 调整Git克隆策略 #

在.gitlab-ci.yml中添加以下配置，避免浅克隆导致的子模块校验问题：

variables:
  GIT_STRATEGY: clone
  GIT_SUBMODULE_STRATEGY: recursive

3. 禁用Git多线程扫描 #

错误提示涉及线程化lstat操作，可强制Git使用单线程执行子模块更新：

GIT_DISABLE_THREADS=1 git submodule update --init --recursive

4. 修复Composer进程启动问题 #

• 在CI脚本中临时调整系统进程数限制：ulimit -u 1024（可根据实际情况调整数值）
• 检查CI使用的Docker镜像，确保安装了完整Git工具链，轻量镜像可能缺失依赖导致进程启动失败。

5. 验证文件系统驱动 #

若使用Docker executor，检查是否采用overlay2存储驱动，部分场景下该驱动的权限规则会阻断线程化文件操作，可尝试切换到aufs或调整Docker存储配置。

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