### 如何在 FastAPI 中强制使用本地 ReDoc 资源 为了使 FastAPI 的 `/redoc` 接口能够正常工作并使用本地的 ReDoc 静态资源，可以按照以下方法操作： #### 下载静态资源 首先需要从 GitHub 上获取 ReDoc 的静态资源文件。可以通过以下链接找到最新的版本： - [ReDoc 开源地址](https://github.com/Redocly/redoc) 下载完成后，将 `bundles/redoc.standalone.js` 和其他必要的资源（如图标等）放置到项目的指定目录中，例如 `static/redoc`。 #### 修改 `docs.py` 进入 Python 解释器环境中安装的 `fastapi` 库路径下的 `openapi/docs.py` 文件。通常该文件位于类似于以下位置： ``` \Lib\site-packages\fastapi\openapi\docs.py ``` 打开此文件后，注释掉默认的 ReDoc URL 设置部分，并替换为指向本地资源的路径。以下是具体的代码片段： ```python from starlette.staticfiles import StaticFiles 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 默认 CDN 地址为本地路径 redoc_js_url: str = "/static/redoc/bundles/redoc.standalone.js" # 指向本地 ReDoc JS 文件 redoc_favicon_url: str = "/static/redoc/favicon.png" # 指向本地 favicon 图标 ``` #### 主程序中的挂载设置 最后，在主应用程序文件中添加对静态资源目录的支持。通过 `app.mount()` 方法实现这一功能： ```python from fastapi import FastAPI from starlette.staticfiles import StaticFiles app = FastAPI() # 将 /static 映射至 static 目录 app.mount("/static", StaticFiles(directory="static"), name="static") ``` 完成以上步骤之后重新启动应用服务即可生效。此时访问 `/redoc` 页面时会加载本地存储的 ReDoc 静态资源而非依赖外部网络连接[^1]。 --- ### 注意事项 如果调整后的项目结构与示例不同，则需同步更新 `docs.py` 内部定义的相关路径以匹配实际布局。此外还需确认所引用的所有静态资产均已妥善存放在相应子文件夹里以便顺利调用[^2]。 ---