nginx配置变更后自动执行nginx -t校验是保障服务稳定的关键，可通过shell脚本实现：检测文件修改、调用nginx -t语法检查、依退出码输出提示并可选中止后续操作。
在Nginx配置变更后自动执行 nginx -t 校验语法正确性，是保障服务稳定上线的关键一步。通过Shell脚本实现该流程，可嵌入CI/CD、Git钩子或配置同步任务中，避免人为遗漏。
核心思路：监听变更 + 执行校验 + 反馈结果
不依赖复杂工具，仅用基础命令组合即可完成：
- 检测指定Nginx配置文件（如
/etc/nginx/nginx.conf或整个/etc/nginx/conf.d/目录）是否被修改 - 调用
nginx -t进行语法检查 - 根据退出码（0为成功，非0为失败）输出明确提示，并可选中止后续操作
基础校验脚本（推荐直接使用）
保存为 check-nginx-conf.sh，赋予执行权限：chmod +x check-nginx-conf.sh
#!/bin/bash # 配置路径（按需修改） NGINX_CONF="/etc/nginx/nginx.conf" NGINX_BIN=$(command -v nginx) <p>if [[ ! -x "$NGINX_BIN" ]]; then echo "错误：未找到 nginx 可执行文件" exit 1 fi</p><p>echo "▶ 正在校验 Nginx 配置：$NGINX_CONF" if "$NGINX_BIN" -t; then echo "✅ 语法校验通过，配置可用" exit 0 else echo "❌ 语法校验失败，请检查配置" exit 1 fi </p>
进阶：配合文件变更监听（inotifywait 方式）
适用于开发测试环境实时响应配置改动（需安装 inotify-tools）：
#!/bin/bash CONF_DIR="/etc/nginx" INOTIFY_CMD=$(command -v inotifywait) <p>if [[ ! -x "$INOTIFY_CMD" ]]; then echo "请先安装 inotify-tools：apt install inotify-tools（Debian/Ubuntu）或 yum install inotify-tools（CentOS/RHEL）" exit 1 fi</p><p>echo "? 监听 $CONF_DIR 下的配置变更..." while inotifywait -e modify,move,create,delete "$CONF_DIR"; do echo "⚠️ 配置可能已更改，正在校验..." if nginx -t &>/dev/null; then echo "✅ 校验通过" else echo "❌ 校验失败 —— 请勿 reload！" nginx -t # 显示详细错误信息 fi done </p>
集成到 Git Hook 或 CI 流程中
例如在 .git/hooks/pre-commit 中加入：
# 检查是否修改了 nginx 配置
if git diff --cached --name-only | grep -qE '\.(conf|nginx)$'; then
echo "检测到 Nginx 配置变更，执行语法校验..."
if ! /path/to/check-nginx-conf.sh; then
echo "提交被拒绝：Nginx 配置语法错误"
exit 1
fi
fi
在 GitHub Actions 或 Jenkins 中，只需在部署前添加一步运行该脚本即可。
不复杂但容易忽略的是：确保脚本中使用的 nginx 命令路径与实际一致（尤其当存在多版本或自编译安装时），建议显式指定 NGINX_BIN 路径；同时注意执行权限和用户权限（如需读取受保护的 conf 文件，脚本应以 root 或 nginx 所属组身份运行）。
