运行GitLab流水线提示Missing CI config file但.gitlab-ci.yml已存在

• 校验CI配置路径是否匹配：进入项目 → 设置 → CI/CD → 通用管道 → CI/CD 配置文件 字段，确认填写的路径和你实际存放.gitlab-ci.yml的路径完全一致，根目录存放填默认.gitlab-ci.yml即可，子目录存放要补全完整相对路径，注意GitLab路径大小写敏感。
• 确认文件提交到对应分支：检查.gitlab-ci.yml是否已经提交并推送到当前触发流水线的分支/标签上，避免出现本地有文件、远程对应分支无文件，或者仅提交到其他分支的情况。
• 检查文件名是否准确：确认文件名完全为.gitlab-ci.yml，无多余后缀（比如Windows系统默认隐藏后缀容易生成.gitlab-ci.yml.txt文件）、无多余空格或特殊字符，可在项目根目录执行ls -a命令查看真实文件名。
• 排查.gitignore规则：检查项目.gitignore文件内容，确认没有把.gitlab-ci.yml列入忽略规则，导致文件被排除在版本控制之外无法被GitLab识别。
• 校验文件权限：确认.gitlab-ci.yml的文件权限允许GitLab运行器读取，常规设置为644权限即可，可执行chmod 644 .gitlab-ci.yml修正权限问题。
• 重新校验配置语法：如果之前用的是本地IDE做格式校验，建议用GitLab自带的CI Lint工具校验：进入项目 → CI/CD → 流水线 → 右上角「CI Lint」，粘贴文件内容校验，可以识别IDE无法检测的GitLab专属语法错误。
• 排查上层配置覆盖：如果项目属于某个GitLab组，检查组级是否设置了强制CI配置覆盖了项目级配置；如果项目使用了子模块，确认子模块拉取逻辑不会覆盖项目根目录的CI配置文件。

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