Django项目部署后静态资源无法加载，求排查解决

为什么日志中路径是staticfiles，而请求路径是static？ #

这是Nginx配置的正常映射结果：你的Nginx配置里location /static/块使用了alias /home/muser/django-site/staticfiles/;，当客户端请求/static/js/owl.carousel.min.js时，Nginx会将请求路径替换为alias指定的目录路径，也就是/home/muser/django-site/staticfiles/js/owl.carousel.min.js，所以日志里会显示这个实际文件路径。这个映射逻辑是正确的，问题不在路径配置。

权限拒绝的原因及解决方法 #

这个Permission denied是文件系统权限问题：Nginx进程默认以www-data用户身份运行，而/home/muser/django-site/staticfiles/目录或其中的文件没有给www-data用户授予读取权限，导致Nginx无法访问这些静态文件。

解决步骤： #

1. 检查当前权限
   先查看staticfiles目录及其文件的权限和所有者：

   ls -ld /home/muser/django-site/staticfiles/
   ls -l /home/muser/django-site/staticfiles/js/owl.carousel.min.js
   

   输出中如果所有者不是www-data，且其他用户没有读权限，就会出现这个问题。

2. 修复权限
   推荐将staticfiles目录的所有者改为Nginx运行用户www-data：

   sudo chown -R www-data:www-data /home/muser/django-site/staticfiles/
   

   如果你不想修改所有者，也可以给所有用户添加读权限（注意：这种方式安全性稍低，仅在必要时使用）：

   sudo chmod -R 755 /home/muser/django-site/staticfiles/
   

3. 确保父目录权限
   还要保证父目录/home/muser/django-site/有足够的权限让Nginx能进入：

   sudo chmod 755 /home/muser/django-site/
   

4. 重启Nginx生效
   修改权限后重启Nginx服务：

   sudo systemctl restart nginx
   

额外注意事项： #

• 生产环境务必将settings.py中的DEBUG设为False，否则Django会自行处理静态文件，但这不适用于生产场景，且存在安全隐患。
• 确认已经执行过python manage.py collectstatic命令，将所有应用的静态文件收集到STATIC_ROOT指定的staticfiles目录中。

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