You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

部署后drf-yasg中Swagger UI的CSS/JS无法加载问题求助

解决Swagger UI静态文件加载失败的问题
  • 先确认静态文件已收集
    部署环境下一定要执行python manage.py collectstatic命令,把drf-yasg等所有应用的静态文件收集到STATIC_ROOT指定的目录里。如果没做这一步,服务器找不到静态文件,就会返回404页面(MIME类型为text/html),直接导致样式和脚本加载失败。

  • 检查服务器静态文件配置
    以Nginx为例,要在配置里添加静态文件的路由规则,指向你的STATIC_ROOT实际路径:

    location /static/ {
        alias /实际项目路径/static/;
    }
    

    用Apache的话,也要配置对应的Alias规则,确保/static/开头的请求直接由服务器返回静态文件,而不是转发给Django处理。

  • 验证静态文件目录权限
    确保STATIC_ROOT对应的static目录有服务器进程的读写权限,避免因为权限不足导致服务器无法读取静态文件,返回错误页面。

  • 清除浏览器缓存
    有时候浏览器会缓存之前的错误响应,按下Ctrl+F5强制刷新页面,或者直接清除浏览器缓存后再访问Swagger UI。

内容的提问来源于stack exchange,提问作者Megha Agrawal

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.02 08:25:45