Nginx无法找到静态文件求助：同配置服务器Django静态文件访问404（Vue服务正常）

这种情况我之前也碰到过——看似配置完全一致，但就是一台正常一台报404，大概率是一些容易被忽略的细节问题，咱们一步步来排查：

• 检查静态文件的权限与归属
  Nginx通常以www-data（部分系统是nginx）用户运行，必须确保这个用户能读取/var/www/html/static下的所有文件和目录。

  1. 先查看Nginx的运行用户：ps aux | grep nginx
  2. 检查静态文件目录的权限和归属：ls -l /var/www/html/static
  3. 如果权限不对，执行以下命令修正：

     chown -R www-data:www-data /var/www/html/static
     chmod -R 755 /var/www/html/static
     

• 确认Nginx配置生效且无语法错误
  有时候配置修改后没重载，或者存在隐性语法错误：

  1. 检查配置语法合法性：nginx -t
  2. 重载Nginx使配置生效：systemctl reload nginx（或service nginx reload，依系统而定）
  3. 重点确认两台服务器的所有Nginx配置文件完全一致，包括/etc/nginx/conf.d/或其他include引入的子配置，别漏了这些细节。

• 验证root/alias指令的正确性
  你的root配置location /static/ { root /var/www/html; }是正确的，对应实际路径/var/www/html/static/；如果用alias，必须注意末尾斜杠：

  location /static/ {
      alias /var/www/html/static/; # 末尾斜杠不能少，否则路径会拼接错误
  }
  

  可以做个简单测试：在/var/www/html/static下放一个test.txt，访问http://你的服务器地址/static/test.txt，同时查看Nginx错误日志/var/log/nginx/error.log——日志会明确显示Nginx实际尝试访问的文件路径，一眼就能看出路径是否错误。

• 确认Django静态文件已正确收集
  虽然另一台服务器正常，但这台可能没执行静态文件收集命令，或者收集过程有权限问题：

  1. 执行python manage.py collectstatic（确保用Django项目对应的Python环境）
  2. 对比两台服务器/var/www/html/static目录下的文件数量和内容，确认是否完全一致。

• 检查SELinux或防火墙限制
  即使文件权限正确，SELinux也可能阻止Nginx访问目录：

  1. 临时关闭SELinux测试：setenforce 0，如果此时能访问静态文件，说明是SELinux的问题，执行以下命令永久配置规则：

     chcon -R -t httpd_sys_content_t /var/www/html/static
     

  防火墙方面，因为Vue服务能正常运行，端口应该没问题，但也可以确认下80/443端口是否开放。

• 查看Nginx日志定位问题
  这是最直接的方法：

  • 访问日志/var/log/nginx/access.log：可以看到请求的URI和返回状态码
  • 错误日志/var/log/nginx/error.log：会详细记录Nginx找不到文件的原因（路径错误、权限拒绝等）

先从日志和权限入手，这两个是这类问题最常见的诱因，一般都能快速定位解决。

内容的提问来源于stack exchange，提问作者Beliaf