部署Django到Linux服务器后CSS加载失败（Nginx静态文件403）

常见原因及解决方案 #

1. 静态文件目录权限不足 #

Nginx运行用户（通常是www-data或nginx）需要拥有静态文件目录的读权限，以及父目录的执行权限（才能进入目录）。

• 先确认Nginx运行用户：

  ps aux | grep nginx
  

• 给父目录添加执行权限：

  chmod +x /home/paul /home/paul/myproject
  

• 给静态文件目录及文件添加读权限（二选一即可）：
  • 方法一：修改目录所有者为Nginx用户

    chown -R www-data:www-data /home/paul/myproject/static
    

  • 方法二：开放目录读权限给所有用户

    chmod -R 755 /home/paul/myproject/static
    

2. 检查SELinux限制（仅针对开启SELinux的服务器） #

如果服务器开启了SELinux，即使文件权限正确，Nginx也可能被限制访问目录。

• 临时关闭SELinux测试：

  setenforce 0
  

  刷新页面如果静态文件正常加载，说明是SELinux的问题，需要添加上下文规则：

  # 添加临时上下文
  chcon -Rv --type=httpd_sys_content_t /home/paul/myproject/static/
  # 添加永久上下文规则
  semanage fcontext -a -t httpd_sys_content_t "/home/paul/myproject/static(/.*)?"
  restorecon -Rv /home/paul/myproject/static/
  

3. 确认已执行Django静态文件收集 #

部署时必须运行collectstatic命令，将所有App的静态文件汇总到STATIC_ROOT目录：

python manage.py collectstatic

执行时确认文件被正确收集到/home/paul/myproject/static/下。

4. 验证Nginx配置路径 #

当前Nginx配置中root /home/paul/myproject是正确的，访问/static/css/xxx.css时，Nginx会查找/home/paul/myproject/static/css/xxx.css，和你的目录结构匹配。如果不确定，可以替换为alias配置（效果一致）：

location /static/ {
    alias /home/paul/myproject/static/;
}

修改配置后重启Nginx：

sudo systemctl restart nginx

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