### 如何在 FastAPI 中使用 Swagger UI 进行 API 测试 #### 配置本地环境以支持 Swagger UI 为了使 FastAPI 支持离线模式下的 Swagger UI 功能，可以按照以下方法操作： 1. **下载静态资源** 下载官方提供的 Swagger UI 静态文件，并将其存储到项目的指定目录下。例如，创建一个名为 `static` 的文件夹并将这些文件放入子文件夹 `/swagger-ui/` 中[^1]。 2. **修改默认路径设置** 编辑 FastAPI 安装目录中的 `fastapi/openapi/docs.py` 文件，将原本指向外部 CDN 的链接替换为本地文件路径。例如： ```python 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-32x32.png" ``` 对于 Redoc 的配置同样适用： ```python redoc_js_url: str = "/static/redoc/bundles/redoc.standalone.js" redoc_favicon_url: str = "/static/redoc/favicon.png" ``` 此外，还需要确保注释掉原有的远程 URL 设置部分[^2]。 3. **集成静态文件服务** 在应用初始化阶段通过挂载静态文件的方式提供访问入口。这可以通过调用 `StaticFiles` 类实现： ```python from fastapi import FastAPI from fastapi.staticfiles import StaticFiles app = FastAPI() # 挂载静态文件目录 app.mount("/static", StaticFiles(directory="static"), name="static") ``` 4. **启动并验证功能** 当完成以上步骤之后，运行应用程序即可看到自定义的 Swagger 接口文档页面正常工作。此时即使处于无网络连接状态也能顺利浏览和调试接口[^1]。 #### 使用 Swagger UI 测试 API 方法 一旦成功部署好带有 Swagger UI 的 FastAPI 应用程序，则可通过以下方式进行交互式测试： - 访问地址通常位于根域名后面加上 `/docs` 路径（如 http://localhost:8000/docs），这里会展示所有已注册路由及其参数详情。 - 利用界面上直观的操作按钮来发送 GET、POST 等类型的 HTTP 请求给目标端点；填写必要字段后点击“Try it out”，随后执行实际调用查看返回结果。 - 如果遇到任何错误提示，请参照报错信息调整输入数据直至满足预期条件为止。 ---