GitLab CI/CD流水线自动触发异常求助：提交代码后无法自动运行

我之前也碰到过一模一样的情况！推送代码后流水线完全没反应，每次都得手动跑，折腾了好半天才排查出几个常见原因，你可以挨个检查试试：

• 确认CI/CD配置文件的正确性：先看看仓库根目录有没有.gitlab-ci.yml文件，拼写和路径都不能错——我之前就不小心把文件放到了子文件夹里，导致GitLab根本检测不到配置。另外可以用GitLab仓库里的「CI/CD」→「Editor」来验证配置语法是否正确，有语法错误也会导致流水线不触发。
• 检查项目CI/CD开关状态：进入项目的「Settings」→「CI/CD」→「General pipelines」，确保「Enable CI/CD」选项是勾选状态。有时候项目初始化或者权限变更后这个开关会被意外关闭。
• 排查触发规则限制：打开你的.gitlab-ci.yml，看看有没有设置only、except或者rules字段。比如如果写了only: [tags]，那只有打标签的提交才会触发流水线；要是误加了rules: - if: $CI_PIPELINE_SOURCE == "manual"，那只能手动触发。可以先暂时注释掉这些规则，提交测试看看能不能自动触发。
• 验证受保护分支的流水线权限：如果你推送到的是受保护分支，进入「Settings」→「Repository」→「Protected branches」，查看对应分支的配置，确认「Allowed to push and merge」的用户/组有没有权限触发流水线，以及「Pipeline trigger」选项是否开启。
• 检查Runner状态：如果用的是自己部署的GitLab Runner，进入「Settings」→「CI/CD」→「Runners」，确认Runner是「Online」状态，并且标签和你流水线里指定的tags匹配。要是Runner离线或者标签不匹配，流水线会一直处于pending状态，看起来就像没触发一样。
• 查看Webhook和系统事件：进入「Settings」→「Webhooks」，检查有没有异常的第三方Webhook干扰了默认触发；另外可以去项目的「CI/CD」→「Pipelines」页面，点击右上角的「Run pipeline」旁边的下拉箭头，查看「Pipeline history」里有没有失败的触发记录，或者去「Admin Area」（如果你有权限）看看系统日志有没有相关报错。

我当时的问题是在.gitlab-ci.yml里误加了only: [manual]，删掉之后流水线就正常自动触发了。你可以先从检查配置文件和开关这些简单步骤开始，大概率能找到问题！

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