解决 nginx 的 404 问题,核心在于理解 root 和 alias 对路径拼接逻辑的不同处理:root 将 location 后的路径作为前缀追加到配置的根目录下,而 alias 则用其配置的路径完全替换 location 中的路径。当请求路径与文件实际存放位置不匹配时,通常是因为混淆了这两种机制导致的拼接错误。

root 指令如何拼接路径导致 404
使用 root 时,Nginx 会将 location 块中定义的路径直接拼接到 root 指定的目录之后。如果 location 路径包含多余层级或与实际目录结构不符,就会指向不存在的文件。

server {
listen 80;
server_name example.com;
# 假设物理文件位于 /var/www/html/images/photo.jpg
location /images/ {
root /var/www/html;
}
}
在上述配置中,访问 /images/photo.jpg 时,Nginx 会尝试在 /var/www/html + /images/ + photo.jpg 即 /var/www/html/images/photo.jpg 下查找文件。这是正确的行为。但如果配置写成 location /img/ { root /var/www/html; },访问 /img/photo.jpg 则会去 /var/www/html/img/photo.jpg 找文件,若该路径不存在则返回 404。
alias 指令如何替换路径避免 404
使用 alias 时,Nginx 会用 alias 指定的路径完全替换 location 中的路径部分。这意味着 location 中的路径仅作为匹配规则,不参与最终的文件系统路径构建。

server {
listen 80;
server_name example.com;
# 假设物理文件位于 /var/www/static/images/photo.jpg
location /old-images/ {
alias /var/www/static/images/;
}
}
在此配置中,访问 /old-images/photo.jpg 时,Nginx 会忽略 /old-images/,直接使用 alias 的值 /var/www/static/images/ 加上请求的文件名 photo.jpg,即 /var/www/static/images/photo.jpg。注意 alias 路径末尾必须加斜杠,否则会导致文件名拼接错误。
基于 alias 路径末尾斜杠的具体问题
在使用 alias 时,如果路径末尾缺少斜杠,会导致严重的 404 错误,因为 Nginx 会将请求的文件名直接拼接到目录路径上,形成非法的文件名。
server {
listen 80;
server_name example.com;
# 错误示例:缺少末尾斜杠
location /files/ {
alias /var/www/data/files;
}
}
当访问 /files/report.pdf 时,由于 alias 路径没有斜杠,Nginx 会尝试访问 /var/www/data/filesreport.pdf,这显然是一个不存在的文件,从而返回 404。正确做法是确保 alias 值以斜杠结尾,如 alias /var/www/data/files/;,这样才会正确拼接为 /var/www/data/files/report.pdf。


















