共计 4635 个字符,预计需要花费 12 分钟才能阅读完成。
Nginx 重载报出端口占用,而旧站点仍能访问,常见解释是新配置应用失败后,旧配置继续服务。先确认操作确实是 reload,并把报错时间、监听归属和目标 master 对齐。网页可访问不能证明变更成功;单独的语法检查和进程列表也不足以证明新配置已生效。
重载失败后,为什么旧连接还能使用
Nginx 官方进程控制文档说明,master 在 HUP 重载时会检查并尝试应用新配置,包括打开日志与新增监听套接字;应用失败会回退并继续旧配置。成功后才启动新 worker,再让旧 worker 优雅退出。因此应先查清失败点,避免直接 restart 中断仍可用的服务。
这篇讨论进程控制和监听冲突。SSL 模块文档适合解释 HTTPS 指令,不能单独支撑 reload 机制。配置里的 listen 443 ssl; 只是监听示例,并不是完整的 HTTPS 部署教程。
先固定目标实例,避免检查一个、重载另一个
以下适用于 Linux、Bash、已有 Nginx 安装及有权限读取目标配置的账号。先确认实际可执行文件、主配置、prefix、错误日志和监听端口。软件包、宝塔、容器中的路径和命名空间可能不同;多 master 还可能是正常升级的过渡状态,不能看到两个进程就删除其中一个。
先查看进程命令和已确认可执行文件的构建参数。下列路径只是软件包安装的示例,必须按实际实例替换;容器实例应在对应容器或网络命名空间内检查。
ps -o pid,ppid,lstart,args -C nginx
/usr/sbin/nginx -V 2>&1
把 master 的启动参数与 -V 显示的默认路径一起核对。-c 选择主配置,-p 指定 prefix,不能只依赖 PATH 中的第一个 nginx。命令参数含义见官方命令行参数说明。
完整采集脚本:保留失败状态,不隐藏配置错误
将下面完整脚本保存为 nginx-inspect.sh。它执行版本、配置、监听和日志检查,不发送 reload 或 stop 信号,不写 Nginx 配置。为避免配置转储暴露凭据,完整转储只进入权限受限的临时目录,终端只打印 listen 行;退出时清理自己的临时文件。输出仍可能包含内部路径和日志信息,请留在受控环境中。
#!/usr/bin/env bash
# Linux / Bash example. It never sends reload/stop signals or changes nginx files.
set -u
set -o pipefail
umask 077
if (( $# != 5 )); then
printf 'Usage: %s ABS_NGINX ABS_CONF ABS_PREFIX PORT ABS_ERROR_LOG\n' "$0" >&2
exit 2
fi
nginx_bin=$1
nginx_conf=$2
nginx_prefix=$3
port=$4
error_log=$5
if [[ $nginx_bin != /* || ! -x $nginx_bin || $nginx_conf != /* || ! -r $nginx_conf || $nginx_prefix != /* || ! -d $nginx_prefix ]]; then
printf 'Check executable, config and prefix absolute paths first.\n' >&2
exit 2
fi
if [[ ! $port =~ ^[0-9]{1,5}$ ]] || (( 10#$port < 1 || 10#$port > 65535 )); then
printf 'PORT must be 1..65535.\n' >&2
exit 2
fi
for command_name in mktemp awk ps ss tail cat rm rmdir; do
command -v "$command_name" >/dev/null || { printf 'Missing tool: %s\n' "$command_name" >&2; exit 2; }
done
workdir=$(mktemp -d) || exit 1
cleanup() {
rm -f -- "$workdir/test.txt" "$workdir/config.txt" "$workdir/dump-error.txt"
rmdir -- "$workdir"
}
trap cleanup EXIT
trap 'exit 130' INT
trap 'exit 143' TERM
printf '\n[1] Executable and build options\n'
"$nginx_bin" -V 2>&1
printf '\n[2] Test the selected config\n'
"$nginx_bin" -p "$nginx_prefix" -c "$nginx_conf" -t >"$workdir/test.txt" 2>&1
test_status=$?
cat "$workdir/test.txt"
if (( test_status != 0 )); then
printf 'Config test failed; no reload was attempted.\n' >&2
exit "$test_status"
fi
printf '\n[3] listen directives from disk, not an active-config dump\n'
"$nginx_bin" -p "$nginx_prefix" -c "$nginx_conf" -T >"$workdir/config.txt" 2>"$workdir/dump-error.txt"
dump_status=$?
if (( dump_status != 0 )); then
cat "$workdir/dump-error.txt" >&2
exit "$dump_status"
fi
awk '/^# configuration file / { file = $0 } /^[[:space:]]*listen[[:space:]]/ { print file; print NR ":" $0 }' "$workdir/config.txt"
printf '\n[4] nginx processes and start times\n'
ps -o pid,ppid,lstart,args -C nginx || true
printf '\n[5] TCP listener owners for port %s\n' "$port"
ss -ltnp "sport = :$port"
printf '\n[6] Recent configured error log; keep output private\n'
if [[ $error_log = /* && -r $error_log ]]; then
tail -n 30 -- "$error_log"
else
printf 'Error log is unreadable; check its path and permission.\n' >&2
fi
printf '\nInspection finished. No reload, restart, kill or config write was performed.\n'
调用时提供全部五个参数,下面是 Linux 软件包安装的调用示例。使用宝塔时应换成该实例真实的 Nginx 可执行文件、主配置、prefix 和日志路径,不能把这组值直接当作本站配置。
bash nginx-inspect.sh \
/usr/sbin/nginx \
/etc/nginx/nginx.conf \
/usr/share/nginx/ \
80 \
/var/log/nginx/error.log
脚本的配置检查失败会返回非零退出码并停止后续配置转储,不会通过 2>/dev/null | grep 把前一步错误隐藏。nginx -t 检查语法及所引用文件;-T 另外打印磁盘上的配置文件。它们都不是 master 当前内存配置的读取接口,也不能仅据此断定新配置已经装载。
按同一次报错解释结果
| 观察 | 可以支持的判断 | 还需要核对 |
|---|---|---|
| 配置检查失败 | 当前选中的配置或引用文件有问题 | 报错文件、行号、读取权限及实例是否选对 |
| 日志出现 Address already in use | 该次应用尝试存在绑定失败 | 具体地址、端口、命名空间和进程归属 |
| 端口归属是 WAF、代理或容器 | 需核对外部入口与源站端口分工 | 是否计划让多个服务使用相同地址端口 |
| 多个 server 使用相同 listen | 可能是正常的名称虚拟主机配置 | 监听选项是否矛盾、是否存在第二个独立实例,不能仅凭重复文字判冲突 |
| 旧 worker 仍存在 | 旧连接可能仍在排空,或重载未成功 | 新 worker 是否出现、对应日志和真实请求行为 |
单独看 PID 或启动时间会受到重启、升级和连接排空的影响。应把同一时间段的日志、master/worker 关系、套接字和预期业务行为一起检查。不要仅凭 Server 响应头认定进程归属。
完整最小配置示例:看清配置层级
下面是独立测试实例的完整主配置,使用回环地址的高端口和固定健康响应,帮助理解 events → http → server → location 层级。它不是现有 WordPress 配置的替代品,不能直接覆盖生产主配置,也没有配置 HTTPS、PHP 或反向代理。在隔离环境里先确认端口空闲,并按需要调整 PID 和日志位置;本文没有在本站启动它。
worker_processes 1;
pid /tmp/nginx-inspect-demo.pid;
error_log /tmp/nginx-inspect-demo-error.log notice;
events {
worker_connections 64;
}
http {
access_log off;
server {
listen 127.0.0.1:18080;
server_name localhost;
location = /healthz {
default_type text/plain;
return 200 "nginx-demo-v1\n";
}
}
}
完整主配置包含 events 和 http;若只提供 server {},必须说明它是放在已有 http 上下文中的局部配置。现有站点修改监听时,优先修正具体冲突项,保留原来的 PHP、代理和权限配置。关于配置层级可参阅Nginx 官方入门文档。
修改后如何验证,失败如何回退
- 保留目标配置原件及文件属主、权限,记录准备修改的监听行;确认现有可用服务和回滚负责人。
- 在正确实例中只改已确认的冲突,先运行同一可执行文件、同一 prefix 和同一主配置的检查。
- 检查通过后再按当前服务管理方式平滑重载,随后查看本次错误日志和新 worker。不要把发送信号命令返回成功当作 master 已经接受新配置。
- 从实际客户端路径验证预期行为。HTTPS 变更应验证真实入口返回的证书;代理变更应验证上游及应用响应,不能只看 HTTP 200。
- 若新配置未装载,保留仍可用的旧服务,恢复目标文件原件后重新检查;确认应用失败原因后再安排重载,避免反复 restart。
下面只展示命令结构,路径必须先按目标实例确认。-s reload 会改变服务运行状态,应在完成上述核查后执行;本文未在本站执行这些示例命令。
nginx_bin=/usr/sbin/nginx
nginx_conf=/etc/nginx/nginx.conf
nginx_prefix=/usr/share/nginx/
"$nginx_bin" -p "$nginx_prefix" -c "$nginx_conf" -t || exit $?
"$nginx_bin" -p "$nginx_prefix" -c "$nginx_conf" -s reload
配置、日志和进程证据共同支持判断;实际验证仍以对应实例、网络命名空间和业务路径为准。
常见问题
nginx -T 能读取 master 当前的生效配置吗?
不能。它测试并打印选中的磁盘配置文件,不能替代进程、日志和实际请求验证。
重复的 listen 行一定会引起端口冲突吗?
不一定。多个名称虚拟主机可共享监听,必须结合监听选项、目标地址与独立实例判断。
发送 reload 信号命令返回成功,就表示重载成功吗?
不能。还需确认 master 应用配置的日志、新 worker 与预期业务行为。
引用资料
资料链接仅表示正文使用了该素材,不代表所有结论已独立核验。