GitLab CI 队列冲突指多Pipeline争抢Runner资源导致的延迟、误取消等问题，需通过interruptible控制可取消性、rules/changes减少无效触发、Runner并发限制与标签分流、resource_group保障串行任务来解决。
GitLab CI 处理构建触发的队列冲突，核心在于控制 Pipeline 并发行为、避免资源争抢、确保关键任务优先执行。这类“队列冲突”并非代码合并冲突，而是多个 Pipeline 同时排队等待 Runner 执行时，因资源不足或策略不当导致的延迟、覆盖或误取消问题。
✅ 明确什么是“构建触发的队列冲突”
当多个事件（如 push、MR 更新、定时任务）密集触发 Pipeline 时，可能出现：
- 多个 Pipeline 在同一 Runner 上排队，但旧 Pipeline 未完成，新 Pipeline 却抢占了构建上下文
- MR 更新频繁，旧 Pipeline 被自动取消，但取消逻辑不合理（比如取消了正在验证的关键测试）
- 同一分支连续提交，GitLab 默认“取消旧 Pipeline，只运行最新一次”，但若中间有部署类任务，取消可能导致状态不一致
这本质上是调度策略与业务语义不匹配的问题，不是 Git 冲突，但影响交付稳定性。
? 控制 Pipeline 队列行为的关键配置
1. 启用 interruptible 精准控制可取消性
在 .gitlab-ci.yml 中为非关键 Job 显式标记：
test: script: npm test interruptible: true # 允许被新 Pipeline 中同名 Job 取消 deploy-prod: script: ./deploy.sh interruptible: false # 关键任务永不取消，即使新 Pipeline 触发也排队等它完成
⚠️ 注意：
interruptible: false不代表“跳过队列”，而是让该 Job 在队列中保留位置，不被后续 Pipeline 挤掉。
2. 使用 rules + changes 避免无意义触发
减少无效 Pipeline 进入队列：
build:
script: make build
rules:
- if: $CI_PIPELINE_SOURCE == "merge_request_event"
changes:
- "src/**/*"
- "Dockerfile"
- if: $CI_PIPELINE_SOURCE == "push" && $CI_COMMIT_BRANCH == "main"
changes:
- "**/*.go"这样，文档修改、.gitignore 变更等不会触发构建，从源头降低队列压力。
3. 设置 Runner 并发与作业限制
在 Runner 配置（config.toml）中限制单 Runner 并发数，并按标签分流：
[[runners]]
name = "docker-builder"
url = "https://gitlab.example.com/"
token = "xxx"
executor = "docker"
[runners.docker]
image = "alpine:latest"
[runners.limit]
limit = 2 # 此 Runner 最多同时运行 2 个 Job，防挤占再配合 .gitlab-ci.yml 中的 tags，把 lint/test/deploy 分配到不同 Runner 组，实现物理隔离。
4. 启用 resource_group 防止并发冲突
适用于必须串行执行的任务（如数据库迁移、发布锁）：
migrate-db: script: ./migrate.sh resource_group: database-migration # 同名 resource_group 的 Job 严格串行
GitLab 会保证同一 resource_group 下任意时刻最多一个 Job 运行，其余自动排队，不取消、不跳过。
? 常见误操作与规避建议
❌ 不加区分地开启 “Auto-cancel redundant pipelines”（项目设置 > CI/CD > General pipelines）
→ 导致 MR 更新时，尚未完成的 E2E 测试被取消，掩盖真实失败
✅ 建议：仅对test类 Job 开启interruptible，对deployrelease类关闭❌ 所有 Job 共用同一个 Runner 标签（如
shell），无资源隔离
→ 构建、测试、部署全挤在一起，一个慢 Job 卡住整条流水线
✅ 建议：按职责打标 —tag: build,tag: test,tag: deploy，并分配专用 Runner❌ 定时任务（
schedule）和 MR 触发共用同一套 Job，未做环境区分
→ 每日凌晨跑的cleanup任务可能误删 MR 环境数据
✅ 建议：用only/except或rules明确限定触发源，或用CI_PIPELINE_SOURCE判断上下文
? 小技巧：用 retry + 溢出策略兜底
对偶发性资源竞争（如临时镜像拉取超时），可设置有限重试：
build:
script: docker build -t myapp .
retry:
max_attempts: 2
when:
- runner_system_failure
- stuck_or_timeout_failure再结合你已有的“三次失败自动触发人工介入”机制（2026年7月5日资料），形成闭环防御。
不复杂但容易忽略
