macOS Darwin arm64下GitLab Runner服务启动失败（错误码134）求助
2026-7-6
macOS arm64下GitLab Runner服务启动报错exit status 134的排查方案
1. 排查系统完整性保护(SIP)限制
exit status 134常与内存访问限制或SIP拦截有关，先检查SIP状态：
- 执行命令：
csrutil status - 若显示
enabled，可临时关闭SIP测试（重启按住Command+R进入恢复模式，终端执行csrutil disable后重启，再尝试gitlab-runner start）。注意：测试完成后建议重新开启SIP以保障系统安全。
2. 手动指定服务运行用户与权限
默认服务可能因权限不足启动失败，可手动配置运行用户：
- 停止现有服务：
gitlab-runner stop - 重新注册runner并指定当前用户：
gitlab-runner register --user $(whoami) - 或直接修改配置文件
~/.gitlab-runner/config.toml，在[[runners]]区块添加user = "你的用户名" - 再次启动服务：
gitlab-runner start
3. 确认GitLab Runner架构兼容性
确保安装的是适配arm64的版本：
- 执行命令：
file $(which gitlab-runner) - 输出需包含
Mach-O 64-bit executable arm64；若为x86_64版本，按以下步骤重装：- 卸载现有版本：
gitlab-runner uninstall - 下载arm64包：
curl -L https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-darwin-arm64 -o gitlab-runner - 赋予执行权限：
chmod +x gitlab-runner - 移动到系统PATH：
sudo mv gitlab-runner /usr/local/bin/ - 重新注册并启动服务
- 卸载现有版本：
4. 手动重建launchd服务配置
GitLab Runner依赖macOS的launchd管理服务，自动生成的plist文件可能存在问题：
- 卸载现有服务：
gitlab-runner uninstall - 手动生成plist文件：
gitlab-runner install --user $(whoami) --working-directory ~/.gitlab-runner - 加载服务：
launchctl load ~/Library/LaunchAgents/gitlab-runner.plist - 检查服务状态：
launchctl list | grep gitlab-runner
5. 从系统日志提取报错细节
即使runner未生成日志，macOS系统日志可能记录了启动失败原因：
- 执行命令：
log show --predicate 'process == "gitlab-runner"' --info --debug - 从输出中查找具体报错信息（如依赖缺失、路径权限等）
内容的提问来源于stack exchange，提问作者AwsmOfficial
相关产品推荐
相关产品推荐
