Windows GitLab Runner(PowerShell)运行WSL命令异常求助

核心配置调整 #

1. 指定WSL用户与工作目录 #

GitLab Runner服务默认使用系统账户运行，而WSL环境默认绑定本地登录用户，直接执行命令会因环境不匹配出现权限或路径问题。需明确指定WSL用户和流水线工作目录：

qsys-build:
    stage: build     
    script:     
        - wsl -u <你的WSL用户名> -e bash -c "cd /mnt/c/${CI_PROJECT_DIR.Replace('\', '/')} && ls"

或者在PowerShell脚本中处理路径转换：

$wslUser = "your-wsl-username"
$wslRepoPath = $CI_PROJECT_DIR.Replace("C:\", "/mnt/c/").Replace("\", "/")
$wslOutput = wsl -u $wslUser bash -c "cd $wslRepoPath && ls"
Write-Output "WSL执行结果: $wslOutput"

2. 切换GitLab Runner服务的登录账户 #

• 打开服务管理器（运行services.msc），找到gitlab-runner服务
• 右键选择「属性」→「登录」，切换为你本地能正常运行WSL的用户账户（不要用系统内置账户）
• 重启服务后重新触发流水线

权限与环境排查 #

• 检查WSL运行状态：在Runner的PowerShell环境中执行wsl --list --verbose，确认目标WSL发行版处于Running状态。若未运行，先执行wsl -d <发行版名称>完成初始化
• 验证目录权限：确保Runner的工作目录（默认是C:\gitlab-runner\builds\<项目ID>）对Runner运行账户有完整读写权限，WSL访问Windows目录时会继承该权限
• 捕获完整错误信息：修改命令同时捕获stderr输出，定位具体问题：

  $wslOutput = wsl -u $wslUser bash -c "ls 2>&1"
  Write-Output "完整输出: $wslOutput"
  

命令执行优化 #

• 避免引号冲突：PowerShell传递WSL命令时，用单引号包裹内层命令，防止解析错误：

  script:
      - wsl -u your-user bash -c 'ls -la'
  

• 分离WSL逻辑：将需要在WSL中运行的代码写入.sh脚本，直接通过WSL调用，减少命令行嵌套问题：

  script:
      - wsl -u your-user bash ./wsl-build.sh
  

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