GitLab作业显示Pending但已配置活跃Runner的问题咨询

AI 小北

2026-7-23

CI/CD作业卡住但Runner显示在线的排查方案

核对标签匹配度
检查CI配置文件（如.gitlab-ci.yml）中作业的tags字段，必须和Runner设置的标签完全一致（区分大小写）。如果作业指定了标签但Runner无对应标签，作业会无法匹配到Runner。
确认Runner的项目权限
若为项目级Runner，需确保它已关联当前作业所在项目；组级/实例级Runner则要检查是否开启了对该项目的访问权限，可在Runner设置页面的“关联项目”列表中确认。
查看Runner实时日志
以GitLab Runner为例，执行命令查看日志排查报错：
```
sudo gitlab-runner logs --follow
```
日志中可能会显示连接超时、权限不足、作业接收失败等具体问题。
重启Runner服务
若Runner进程假死，表面显示在线但无法接收作业，尝试重启服务：
```
sudo gitlab-runner restart
```
重启后重新触发作业，观察是否恢复正常。
校验CI配置合法性
使用CI平台自带的语法检查工具（如GitLab的CI Lint）验证配置文件，排查语法错误或不符合Runner能力的参数设置（如不存在的环境变量、不支持的执行器）。
检查网络连通性
确认Runner所在服务器能正常访问CI/CD平台的API地址，无防火墙或网络策略拦截。可通过ping或curl测试：
```
curl -v https://你的CI平台域名/api/v4/projects
```