Nginx 访问静态文件出现404

最新推荐文章于 2025-08-01 16:22:50 发布

转载最新推荐文章于 2025-08-01 16:22:50 发布 · 7.6k 阅读

problem 同时被 2 个专栏收录

91 篇文章

订阅专栏

nginx

2 篇文章

订阅专栏

本文介绍了使用Nginx作为静态资源服务器时遇到404NotFound错误的原因及解决方法，对比了root与alias两种配置方式的区别。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在使用nginx做静态资源服务器时，配置完成后通过浏览器访问一直报404 Not Found错误，本人nginx配置信息如下：

location /images/ {  
     root /mnt/upload/files;  
}

所有文件存放在/mnt/upload/files

分析：
发现是配置的问题，配置静态路径有两种方式，之前配置的是直接在URL里写根目录，而现在配置是一个有前缀的URL，所以报404 Not Found错误了。
root配置会在配置的目录后跟上URL，组成对应的文件路径，即想访问的地址是：
https://blog.yoodb.com/images/a.png
nginx根据配置走的文件路径是
/mnt/upload/files/images/a.png
而我需要的是
/mnt/upload/files/a.png

而Nginx提供了另外一个静态路径配置：alias配置
官方root配置
Sets the root directory for requests. For example, with the following configuration

location /i/ {
    root /data/w3;
}

The /data/w3/i/top.gif file will be sent in response to the “/i/top.gif” request

官方alias配置
Defines a replacement for the specified location. For example, with the following configuration

location /i/ {
    alias /data/w3/images/;
}

on request of “/i/top.gif”, the file /data/w3/images/top.gif will be sent.
当访问/i/top.gif时，root是去/data/w3/i/top.gif请求文件，alias是去/data/w3/images/top.gif请求,也就是说
root响应的路径：配置的路径+完整访问路径（完整的location配置路径+静态文件）
alias响应的路径：配置路径+静态文件（去除location中配置的路径）

解决办法：

location /images/ {  
     alias /mnt/upload/files/;  
}

注意：使用alias时目录名后面一定要加“/”；一般情况下，在location/中配置root，在location /*中配置alias。