GitLab CI：当指定文件被修改时在合并分支时显示警告

这绝对是个能帮你避免不少生产坑的需求！毕竟配置更新遗漏导致的环境不一致问题，处理起来真的闹心。在GitLab里，你可以通过两种靠谱的方式实现这个合并时的警告提示，我给你一步步拆解：

方法1：用GitLab CI/CD 实现合并请求警告（无服务器权限也能用） #

这是最通用的方案，不管你用的是GitLab SaaS还是自托管版本，只要能配置CI/CD就能用。核心思路是在合并请求触发的流水线里，检测是否有配置文件被修改，然后输出警告。

1. 在项目根目录创建 .gitlab-ci.yml 文件，添加以下内容：

check-config-updates:
  stage: pre-merge
  script:
    - |
      # 获取合并请求中源分支与目标分支的差异文件列表
      CHANGED_FILES=$(git diff --name-only $CI_MERGE_REQUEST_TARGET_BRANCH_NAME...$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME)
      # 这里替换成你要监控的配置文件路径，支持多个文件或通配符
      WATCHED_CONFIGS="config/app.conf config/environment/*.yml"
      
      # 遍历检查每个配置文件是否被修改
      for CONFIG in $WATCHED_CONFIGS; do
        # 用grep检查差异文件中是否包含目标配置
        if echo "$CHANGED_FILES" | grep -q -F "$CONFIG"; then
          echo -e "\e[31m⚠️ 警告：配置文件 $CONFIG 已被修改！\e[0m"
          echo -e "\e[33m请确认是否已在所有环境（测试/预发布/生产）中同步更新该配置！\e[0m"
          # 如果想强制阻止合并（必须手动确认后放行），可以取消下面的注释
          # exit 1
        fi
      done
  rules:
    # 仅在合并请求触发流水线时运行这个作业
    - if: $CI_PIPELINE_SOURCE == 'merge_request_event'
      when: always

2. 提交这个文件到你的分支，之后所有合并请求都会自动触发这个检测：
   • 如果配置文件被修改，流水线日志里会显示醒目的彩色警告（GitLab支持ANSI颜色）
   • 如果打开了exit 1，作业会失败，直接阻止合并，直到你确认配置已同步后，手动在合并请求页面选择“允许失败”或者修复后重新提交

方法2：自托管GitLab用预接收钩子（全局仓库级检测） #

如果你用的是自托管GitLab，并且有服务器权限，可以用仓库的预接收钩子来实现——这个钩子会在任何代码推送到仓库时触发（包括Web端合并分支后的推送），覆盖所有操作场景。

1. 找到你的项目仓库所在的服务器路径，一般是 /var/opt/gitlab/git-data/repositories/<你的命名空间>/<项目名>.git/hooks/
2. 在该目录下创建 pre-receive 文件，写入以下脚本：

#!/bin/bash
# 预接收钩子：检测配置文件修改并输出警告

# 替换成你要监控的配置文件路径
WATCHED_CONFIGS="config/app.conf config/environment/*.yml"

# 遍历所有推送的引用
while read oldrev newrev refname; do
  # 获取本次推送的差异文件列表
  CHANGED_FILES=$(git diff --name-only $oldrev $newrev)
  
  for CONFIG in $WATCHED_CONFIGS; do
    if echo "$CHANGED_FILES" | grep -q -F "$CONFIG"; then
      echo -e "\e[31m⚠️ 警告：配置文件 $CONFIG 已被修改！\e[0m"
      echo -e "\e[33m请确认是否已在所有环境（测试/预发布/生产）中同步更新该配置！\e[0m"
      # 若要阻止推送，取消下面的注释
      # exit 1
    fi
  done
done

exit 0

3. 给脚本添加执行权限，并确保所属用户是git：

chmod +x pre-receive
chown git:git pre-receive

这样之后，任何修改了配置文件的推送（包括Web端合并分支）都会在控制台或GitLab的推送反馈中看到警告信息。

一些实用提示 #

• 配置文件路径可以根据你的项目调整，比如用*.env监控所有环境变量文件，或者config/**/*.json监控config目录下所有JSON文件（注意git diff的通配符需要配合grep的-F参数）
• 如果用CI/CD方案，建议把警告放在流水线的pre-merge阶段，让用户在合并前就能看到
• 若要强制提醒而不是阻止合并，不要打开exit 1，只保留警告输出即可

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