Windows环境下GitLab CI/CD报exit status 255错误如何解决？

以下是针对该报错的几个有效修复方案，按优先级尝试：

• 检查并修复工作目录权限
  找到GitLab Runner的工作根目录（示例中为D:\gitlab_runner\builds），右键打开「属性」→「安全」标签页：

  • 确保Runner运行所使用的账户（如果是默认安装，通常是SYSTEM账户）拥有该目录及所有子文件夹、文件的完全控制权限；
  • 勾选「将所有子对象权限条目替换为所有父对象的可继承权限条目」，应用后重启GitLab Runner服务。

• 在CI配置中指定Git全局配置文件路径
  在项目的.gitlab-ci.yml中添加before_script步骤，手动指定Git的全局配置文件位置，避免Git在临时目录中寻找配置：

  before_script:
    - git config --global core.gitconfig "C:\Users\<你的用户名>\.gitconfig"
  

  如果你使用系统账户运行Runner，可指定系统级Git配置路径，比如C:\Program Files\Git\etc\gitconfig。

• 修改Runner配置，禁用Git Template目录
  编辑GitLab Runner的config.toml配置文件（默认路径为C:\gitlab-runner\config.toml），在[[runners]]区块内添加Git配置项，跳过git-template目录的使用：

  [[runners]]
    # 其他已有配置...
    [runners.git]
      git_template_dir = ""
  

  保存后重启GitLab Runner服务。

• 升级Git for Windows版本
  旧版本Git在Windows环境下处理临时目录权限存在已知bug，前往Git官方下载最新稳定版安装，安装完成后重启Runner服务。

• 清理旧构建缓存与目录
  手动删除D:\gitlab_runner\builds下的所有旧构建文件夹，清除残留的损坏临时文件，之后重启Runner服务再触发构建。

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