部署后Django Restframework样式失效，如何恢复样式与静态文件正常工作

1. 检查基础配置项 #

• 确认INSTALLED_APPS中包含以下两个应用，必须存在：

  INSTALLED_APPS = [
      # ... 其他应用
      'django.contrib.staticfiles',
      'rest_framework',
  ]
  

• 在settings.py中配置静态文件核心参数：

  # 静态文件访问URL前缀
  STATIC_URL = '/static/'
  # 生产环境下，collectstatic命令收集静态文件的目标目录
  STATIC_ROOT = BASE_DIR / 'staticfiles'
  

2. 收集静态文件（必做） #

运行以下命令，将所有应用（包括DRF）的静态文件统一收集到STATIC_ROOT目录：

python manage.py collectstatic

注意：生产环境部署时必须执行此命令，开发环境若DEBUG=True，Django会自动处理，但建议执行一次验证配置。

3. 验证DRF渲染器配置 #

确保settings.py中的REST_FRAMEWORK配置包含可浏览API的渲染器，否则只会显示纯文本：

REST_FRAMEWORK = {
    'DEFAULT_RENDERER_CLASSES': [
        'rest_framework.renderers.JSONRenderer',
        'rest_framework.renderers.BrowsableAPIRenderer',  # 提供带样式的API界面
    ]
}

4. 开发环境调试 #

• 确认DEBUG = True，Django的runserver会自动处理静态文件服务
• 若样式仍不显示，尝试重启runserver，清除浏览器缓存后刷新页面

5. 生产环境Web服务器配置 #

以Nginx为例，添加静态文件的location配置，指向STATIC_ROOT目录：

server {
    # ... 其他配置
    location /static/ {
        alias /path/to/your/project/staticfiles/;  # 替换为你的STATIC_ROOT绝对路径
        expires 30d;
    }
}

如果使用Apache，配置Alias：

Alias /static/ /path/to/your/project/staticfiles/
<Directory /path/to/your/project/staticfiles/>
    Require all granted
</Directory>

6. 权限检查 #

确保Web服务器运行用户（如www-data）对STATIC_ROOT目录有读取权限，可通过以下命令设置：

sudo chown -R www-data:www-data /path/to/your/project/staticfiles
sudo chmod -R 755 /path/to/your/project/staticfiles

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