Nginx 重载提示端口占用,为什么旧站点还能访问

22次阅读
没有评论

共计 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 官方入门文档。

修改后如何验证,失败如何回退

  1. 保留目标配置原件及文件属主、权限,记录准备修改的监听行;确认现有可用服务和回滚负责人。
  2. 在正确实例中只改已确认的冲突,先运行同一可执行文件、同一 prefix 和同一主配置的检查。
  3. 检查通过后再按当前服务管理方式平滑重载,随后查看本次错误日志和新 worker。不要把发送信号命令返回成功当作 master 已经接受新配置。
  4. 从实际客户端路径验证预期行为。HTTPS 变更应验证真实入口返回的证书;代理变更应验证上游及应用响应,不能只看 HTTP 200。
  5. 若新配置未装载,保留仍可用的旧服务,恢复目标文件原件后重新检查;确认应用失败原因后再安排重载,避免反复 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 与预期业务行为。

引用资料

资料链接仅表示正文使用了该素材,不代表所有结论已独立核验。

正文完
 0
沐小悠
版权声明:本站原创文章,由 沐小悠 于2026-11-17发表,共计4635字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。
评论(没有评论)