GitLab流水线触发失败：Windows 10 Runner系统故障求助

• 检查Runner服务运行权限
  Windows下GitLab Runner默认以Local System账户启动，很多场景下权限不足。打开「服务」找到gitlab-runner，右键选择“属性”→“登录”选项卡，切换为具备管理员权限的本地账户，重启服务后重试流水线。

• 核对Runner配置文件
  打开默认路径下的C:\GitLab-Runner\config.toml，确认：

  • url和token与GitLab项目中注册Runner时的信息完全一致
  • executor设置为shell（Windows环境常用）或docker，无拼写错误
  • 若使用shell executor，shell字段为powershell或cmd，且对应终端能正常执行命令

• 查看Runner日志定位具体问题
  打开命令提示符，执行以下命令启动Runner并查看实时日志：

  gitlab-runner run
  

  触发流水线后，日志会输出详细错误信息（如脚本执行失败、文件权限不足、依赖缺失等），根据日志针对性排查修复。

• 排查流水线脚本的系统兼容性
  若流水线脚本使用了Linux专属命令（如ls、grep），Windows的PowerShell/CMD环境无法识别，需替换为Windows对应命令（dir、findstr），或改用docker executor运行Linux容器执行任务。

• 更新GitLab Runner到最新版本
  旧版本Runner可能存在Windows系统兼容性bug，停止现有gitlab-runner服务，下载最新Windows版Runner覆盖安装，完成后重新注册Runner并启动服务。

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