GitLab拉取Bitbucket仓库时流水线触发失效求助排查

针对你遇到的「Bitbucket过来的Pull Request中修改了Dockerfile，但GitLab流水线未按配置触发」的问题，我整理了几个常见的排查方向和解决办法：

1. 确认CI_PIPELINE_SOURCE变量的实际值 #

你当前规则里用了$CI_PIPELINE_SOURCE == "external_pull_request_event"，但不同外部代码源的PR事件，GitLab可能会用不同的变量值。比如从Bitbucket导入的PR，有些场景下这个变量可能是pull_request而非external_pull_request_event。

调试方法：临时添加一个调试Job，输出该变量的实际内容：

debug_pipeline_source:
  script:
    - echo "当前CI_PIPELINE_SOURCE值为: $CI_PIPELINE_SOURCE"
    - # 顺便输出PR的变更文件，确认Dockerfile是否在变更列表里
    - git diff --name-only $CI_MERGE_REQUEST_TARGET_BRANCH_NAME...$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME
  rules:
    - if: $CI_PIPELINE_SOURCE == "external_pull_request_event" || $CI_PIPELINE_SOURCE == "pull_request"
      when: always

运行后查看输出，就能明确应该用哪个值来匹配Bitbucket的PR事件。

2. 检查changes规则的路径准确性 #

如果你的Dockerfile不在仓库根目录（比如在./services/api/Dockerfile），那当前规则里的- Dockerfile就无法匹配到变更。另外也要确认PR的分支里确实提交了Dockerfile的修改——有时候可能本地改了但没推送到Bitbucket的PR分支。

修正建议：如果是子目录的Dockerfile，把路径写完整：

changes:
  - ./services/api/Dockerfile

如果不确定路径，可以用通配符匹配所有Dockerfile：- **/Dockerfile（注意双星号匹配任意子目录）。

3. 排查外部PR的集成配置 #

确保GitLab和Bitbucket的集成是正确配置的：

• 检查GitLab项目的「Settings > Integrations > Bitbucket」里是否启用了PR同步，且权限足够读取Bitbucket的PR内容。
• 确认GitLab能正确识别Bitbucket的PR事件，比如在GitLab的PR页面能看到来自Bitbucket的关联信息。

4. 检查其他Rules的干扰 #

如果你的.gitlab-ci.yml里还有其他Rules，可能存在规则优先级的问题——前面的规则先匹配成功，就会跳过后面的规则。比如如果有针对分支推送的规则在前面，可能会覆盖PR的规则。

解决办法：把这个PR相关的Rules放在所有规则的最前面，或者给其他规则加上更严格的条件，避免和PR规则冲突。

5. 确认手动触发的入口位置 #

有时候规则已经匹配成功，但手动触发的按钮不在主流水线页面，而是在GitLab对应的PR详情页的「Pipelines」标签下。你可以去那里看看有没有待触发的手动Job。

最后，你可以先把when: manual改成when: always，测试规则是否能匹配成功，确认没问题后再改回手动触发。

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