Linux服务器Nginx出现404错误,如何从站点配置定位原因

发布人:A5数据发布时间:2026-11-06 11:27阅读量:64

同一台 Linux 服务器上,首页正常、图片能打开,只有 /assets/css/ 下的文件返回 404,这类现象不能直接归因于“文件丢了”。请求可能到达了错误的站点,也可能被 Nginx 中优先级更高的 location 接管,最终去错误的目录查找文件。定位时应先确认是谁返回的 404、哪一类路径受影响,再沿实际生效的站点配置追踪请求。

排查 Nginx 站点配置,关键是把“请求的域名、端口、URI”与“命中的 server、location、文件路径”连起来。只检查配置文件里是否写了正确的 root 或 alias,不足以证明请求真的使用了它们。

确认症状:先固定一条可复现的请求

记录一个返回 404 的完整 URL,以及一个同站点、同协议下正常的 URL。例如,https://site.example.com/assets/css/main.css 返回 404,而 /assets/img/logo.png 正常。这里的域名和路径仅作示例,执行命令时须替换成自己的地址。

先从访问端发起 GET 请求,保留响应头;不要只用浏览器页面判断,也不要以 curl -I 的 HEAD 请求替代 GET,因为应用对两种方法可能有不同处理:

curl -sS -D - -o /dev/null https://site.example.com/assets/css/main.css
curl -sS -D - -o /dev/null https://site.example.com/assets/img/logo.png

同时记下故障是“所有路径均 404”,还是“只有静态文件、某个目录或某类扩展名 404”。这个差别决定下一步检查位置:所有路径都异常,优先核对域名和虚拟主机;只有 .css、.js 异常,则应重点检查正则 location;只有应用路由异常,还需继续判断请求是否进入了上游应用。

404 表示有一层服务对请求作出了响应,不等于请求已经到达目标 Nginx。 域名解析、CDN 或前置负载均衡指向了其他站点时,也可能得到 404。相反,连接超时或连接被拒绝通常不属于站点文件路径问题,应先检查监听地址、端口和网络连通性。

建立原因树:按请求经过的层级缩小范围

可以把这次故障分为四个分支,每个分支都要有可观察的依据,而不是凭状态码猜测。

层级需要观察的现象下一步
网络与入口外部请求 404,本机直连目标 Nginx 正常;或两者响应特征不同核对 DNS、CDN 回源目标、负载均衡转发的域名与端口
系统与文件已确认命中目标站点,但目标文件不存在,或目录不可遍历核对实际查找路径、文件及父目录权限
Nginx 服务配置请求进入了错误的 server,或被另一条 location 接管查看运行中实例加载的配置及匹配顺序
应用Nginx 将请求交给上游,上游返回 404核对转发 URI、应用路由和上游日志

这张原因树也给出了排查顺序:先确认入口,再看配置如何解释请求,最后才考虑修改文件或应用。不要因为访问日志出现 404,就立即改权限、重建目录或重启服务。

逐层排除:请求是否进入预期站点

对照外部请求与本机请求

如果站点同时监听 HTTP 和 HTTPS,排查时必须保持协议、域名和端口一致。对于在本机提供 HTTPS 服务的站点,可以让请求直接连接指定 IP,同时保留 URL 中的域名用于 TLS 和站点匹配:

curl -sS -D - -o /dev/null \
  --resolve site.example.com:443:127.0.0.1 \
  https://site.example.com/assets/css/main.css

此命令仅适用于该 Nginx 确实监听本机 127.0.0.1:443 的情况;否则应替换为实际监听的本机 IP。示例域名也须换成证书覆盖的真实域名,不要为方便测试而忽略证书错误。如果站点只监听 HTTP 的 80 端口,可在本机使用 curl -H 'Host: 实际域名' http://127.0.0.1/目标路径 对照。

若外部 404、本机请求正常,优先检查前置入口及其缓存、回源配置;若两边都返回相同的 404,再进入本机站点配置。若本机请求没有到达预期站点,则核对 listen、server_name 和默认站点:同一个域名写在配置里,不代表实际监听该端口的就是这段配置。域名不匹配时,请求可能落入该端口的默认 server。

找到正在加载的配置,而非只找“看起来正确”的文件

Linux 发行版和安装方式不同,Nginx 配置不一定在同一目录;sites-available 中的文件也不一定已被加载。先确认进程和配置入口,再查看展开后的配置:

command -v nginx
ps -eo pid,args | grep '[n]ginx: master'
nginx -V 2>&1
sudo nginx -T 2>&1 | less

nginx -T 会测试并输出加载的配置,适合核对 include、server、location 的实际内容,但输出中可能包含证书路径、认证或上游敏感信息,不应直接贴到公开工单。如果 master 进程使用了自定义 -c 或 -p 参数,检查和测试时也要使用相同参数,否则看到的可能不是运行实例使用的配置。

接着查看该站点实际配置的 access_log、error_log。日志路径可能被站点或 location 覆盖,不能默认只看 /var/log/nginx/。访问日志可帮助确认请求是否进入这个实例;错误日志若出现文件打开失败,通常会给出 Nginx 尝试访问的路径。但有些配置关闭了文件不存在的错误记录,没有对应错误日志并不能证明没有查找文件。

定位根因:检查 location 与文件路径的对应关系

下面是一种典型冲突。站点希望把 /assets/ 映射到 /srv/www/site/assets/,但同时配置了匹配 CSS、JS 的正则规则:

server {
    listen 443 ssl;
    server_name site.example.com;

    root /srv/www/default;

    location /assets/ {
        alias /srv/www/site/assets/;
    }

    location ~* \.(css|js)$ {
        expires 7d;
    }
}

该配置仅展示与路径匹配有关的部分,不是可直接部署的完整 HTTPS 站点配置。请求 /assets/img/logo.png 时,普通前缀 location /assets/ 可以生效;请求 /assets/css/main.css 时,Nginx 在找到普通前缀匹配后,还会检查正则 location。正则规则命中 .css,便使用继承自 server 的 root /srv/www/default,尝试查找:

/srv/www/default/assets/css/main.css

而预期文件位于:

/srv/www/site/assets/css/main.css

例如,错误日志中若出现类似下面的记录,且请求 URI、时间与故障对应,就能把 404 与错误查找路径联系起来;这是一条演示判断方法的模拟记录,并非读者服务器上的检查结果:

open() "/srv/www/default/assets/css/main.css" failed (2: No such file or directory)

这里有两个容易混淆的规则。root 会把完整请求 URI 接到根目录后面;alias 则以指定目录替换命中的 location 前缀。检查 alias 时,要同时核对前缀和目录末尾的斜杠。另一个规则是匹配优先级:普通前缀匹配到 /assets/,不代表匹配过程已经结束;后续正则 location 仍可能接管请求。

定位根因:检查 location 与文件路径的对应关系配图

在这个案例中,如果 /assets/ 下的文件都应作为静态资源直接从该目录提供,可以把前缀规则改为:

location ^~ /assets/ {
    alias /srv/www/site/assets/;
}

^~ 表示该前缀成为最长前缀匹配时,不再检查正则 location。它不是所有 404 的通用修复方式:如果 /assets/ 下部分请求原本就需要由正则规则处理,应重新划分规则,而不是直接加 ^~。

若配置中还存在 try_files,也要沿其参数继续追踪。例如,try_files $uri $uri/ =404 会在文件和目录均未找到时直接返回 404;若最后一个参数是内部跳转 URI,则要继续检查跳转后的 location。应用站点还应区分“Nginx 查找文件失败”与“上游应用返回 404”:查看现有日志中是否记录了上游状态,并结合上游日志核对,不能仅凭响应页面样式断言来源。

最后核对系统层文件状态。确认配置推导出的实际查找路径后,再检查该路径是否存在、父目录是否可遍历:

ls -l /srv/www/site/assets/css/main.css
namei -l /srv/www/site/assets/css/main.css

文件存在但访问异常时,还需结合服务运行用户及系统安全策略检查;权限问题也可能表现为 403,不应为了消除 404 盲目执行递归 chmod 或关闭安全机制。

修改后验证:同时检查配置、请求和回滚路径

修改前,先确认目标文件确实由运行实例加载,并将原文件备份到 Nginx 配置包含目录之外。例如,在已确认实际编辑文件为下列路径、且有维护权限时:

sudo install -d -m 700 /root/nginx-backup
sudo cp -a /etc/nginx/sites-available/site.conf \
  /root/nginx-backup/site.conf.before

路径只是示例,应以实际配置为准。不要把 .bak 文件留在会被通配符 include 的目录里,否则备份也可能被加载,制造新的重复站点或规则冲突。修改影响该站点匹配规则,执行前应确认 /assets/ 下其他资源是否依赖原有正则规则。

改完先测试语法;使用 systemd 管理该服务的环境,可在测试通过后重载:

sudo nginx -t
sudo systemctl reload nginx

若实例使用自定义配置参数,测试和重载方式必须与该实例一致。语法检查通过只说明配置可解析,不说明请求一定命中新规则。随后分别用外部请求和本机直连方式复测故障 CSS、原本正常的图片,以及站点中可能受同一规则影响的 JS 文件;同时检查访问日志中对应请求的状态,确认没有把原有 200 改成 404。

如果新配置引入异常,从配置目录外的备份恢复原文件,再执行配置测试和重载;测试不通过时不要重载:

sudo cp -a /root/nginx-backup/site.conf.before \
  /etc/nginx/sites-available/site.conf
sudo nginx -t
sudo systemctl reload nginx

恢复后仍需复测请求,而不是把“重载命令成功”当作故障已解除。后续可分别监控站点整体 404 比例、/assets/ 等关键路径的 404 变化,以及发布后静态资源的抽样请求。这样既能发现同类 location 冲突复发,也能避免正常的无效 URL 探测掩盖真正受影响的业务路径。

对于需要稳定承载网站、业务后台、数据库和接口服务的场景,A5idc数据提供香港、美国、日本、韩国、中国台湾、新加坡及马来西亚等地区的物理服务器租用方案,覆盖Xeon与AMD EPYC平台,并配备SSD、NVMe、大容量存储、多IP及不同带宽线路。多地区部署与差异化硬件资源,可为Nginx站点、静态资源服务和跨区域业务提供相应的服务器基础。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7878.html

相关推荐