在 nginx 中实现自动检测并平滑重载，核心做法是编写一个 shell 脚本，通过对比配置文件哈希值或关键配置项来触发 nginx -s reload。该脚本通常结合 inotifywait 监听文件变化，或在定时任务中轮询检查，一旦检测到变更即执行重载命令，从而实现配置的无缝更新。
如何基于文件哈希值判断配置是否变更
通过计算当前配置文件与上次记录值的哈希差异来决定是否重载，可以避免因无关文件变动导致的无效重启。具体做法是使用 md5sum 或 sha256sum 生成配置文件的校验和，并与存储的历史值进行比对，若不一致则执行重载并更新记录。
#!/bin/bash
CONFIG_FILE="/etc/nginx/nginx.conf"
HASH_FILE="/var/run/nginx_last_hash"
# 获取当前配置文件的哈希值
current_hash=$(md5sum "$CONFIG_FILE" | awk '{print $1}')
# 读取历史哈希值（如果存在）
if [ -f "$HASH_FILE" ]; then
last_hash=$(cat "$HASH_FILE")
else
last_hash=""
fi
# 比较哈希值
if [ "$current_hash" != "$last_hash" ]; then
echo "Configuration changed. Reloading..."
nginx -s reload
# 更新历史哈希值
echo "$current_hash" > "$HASH_FILE"
else
echo "No changes detected."
fi
上述代码首先定义配置文件路径和哈希存储文件路径。接着使用 md5sum 计算当前 nginx.conf 的哈希值，并提取第一列作为结果。然后读取之前保存的哈希值，若文件不存在则初始化为空字符串。最后比较两者，若不同则执行 nginx -s reload 平滑重载，并更新哈希记录文件；若相同则输出无变更提示。这种方式确保了只有当配置文件内容真正发生变化时才会触发重载操作。
如何利用 inotifywait 实现实时监听重载
利用 inotifywait 工具可以实时监控配置文件的变化，一旦检测到修改事件立即触发重载，相比轮询方式响应更及时。需要安装 inotify-tools 包，并通过循环监听指定目录下的文件事件，捕获到 MODIFY 或 CLOSE_WRITE 事件后执行重载命令。
#!/bin/bash
CONFIG_DIR="/etc/nginx"
# 确保 inotifywait 已安装
if ! command -v inotifywait &> /dev/null; then
echo "inotifywait not found. Please install inotify-tools."
exit 1
fi
echo "Watching for changes in $CONFIG_DIR..."
# 持续监听配置目录
while true; do
inotifywait -q -e modify,close_write "$CONFIG_DIR"/nginx.conf
echo "Configuration file changed. Reloading..."
nginx -s reload
done
该脚本首先检查 inotifywait 是否可用，若未安装则退出并提示安装 inotify-tools。随后进入无限循环，使用 inotifywait 监控 /etc/nginx/nginx.conf 文件的 modify 和 close_write 事件。一旦检测到相关事件，脚本输出提示信息并执行 nginx -s reload 实现平滑重载。此方法适用于需要即时响应配置变更的场景，避免了轮询带来的延迟和资源消耗。
当配置文件包含语法错误时重载会怎样
当配置文件包含语法错误时，nginx -s reload 命令会失败并返回非零退出码，Nginx 主进程不会应用新配置，而是继续使用旧配置运行，同时会在错误日志中记录具体的语法错误信息。因此，在执行重载前建议先使用 nginx -t 测试配置文件的语法正确性，以避免因错误配置导致的服务中断风险。
