这个问题是由于fastapi内置的接口文档使用的外网的cdn
我们在浏览器开发者工具中可以看到它请求了一个js脚本,这个脚本部署在国外,国内无法访问,导致页面卡死在这里,显示空白。
知道这个以后,我们可以讲这些静态资源配置到自己的本地,这些静态资源都在github上开源。
swagger-ui /dist下
redoc
上面两个链接分别是fastapi两种模式下文档接口所需的静态资源开源地址。
这里我抽取出我们所需要的最少的资源放在这。
https://www.aliyundrive.com/s/YuncYSjmMs1
将静态资源下载后放到项目的根目录下,像下图这样
然后我们需要在python解释器环境(或虚拟环境)下Lib/site-package/fastapi/openapi/docs.py文件
修改里面的静态资源访问路径
可以注释文件原有的部分内容,再将复制下面的内容复制进去:
swagger_js_url: str="/static/swagger-ui/swagger-ui-bundle.js",
swagger_css_url: str="/static/swagger-ui/swagger-ui.css",
swagger_favicon_url: str="/static/swagger-ui/favicon.png",
redoc_js_url: str = "/static/redoc/bundles/redoc.standalone.js",
redoc_favicon_url: str = "/static/redoc/favicon.png",
最后在主程序中添加如下代码:app.mount('/static', StaticFiles(directory='static'), name='static')
告诉fastapi以/static开始的路径从static目录中找。
再次启动时访问/docs和/redoc就应该不会有问题了。(如果你修改了静态资源目录结构,你需要对应修改docs.py中对应的路由)
成功运行结果如下: