开个新坑，抽空写一下
内网/linux经常会有下不到swaggerui的情况，为了解决这个方案，可以下载静态文件部署到路由里。
Swagger UI 是 API 文档可视化工具，可自动解析 OpenAPI 规范文件，生成交互式 API 网页。支持在线查看接口路径、请求参数、响应体与状态码，能直接在页面发起接口调试，无需额外客户端。
方便前后端查阅接口定义，简化联调，还可展示接口说明、数据模型。

下了两个文件
我觉得直接用3.5的就可以了
点击文件夹路径输入cmd回车
如果不会查AI去问怎么开cmd到这个路径的基本告别这个贴了
npm pack [email protected]
如果没有npm就是没有node，
curl -O 自己https拼接://registry.npmjs.org/swagger-ui-dist/-/swagger-ui-dist-3.52.5.tgz

如果是外网就简单了，直接服务器路径/docs进去就可以了
新版的fastapi不支持离线了，如果内网部署就老老实实下资源包吧，也不一定是3.52.5，我先去试试

从 github 或者 gitee 下载 swagger_ui

好，***，真费劲，如果各位也遇到像我一样的版本不兼容的情况
1.手写一个.vue文件，准备好包
网页链接
2.给包放到node_modules下
3.package-lock.json和package.json的"dependencies"都加上这个
"dependencies": { "swagger-ui-dist": "^3.52.5" },
4.router/index.js里写上路由
5. const base = (cfg.API_BASE_URL || '').replace(/\/$/, '') // 去掉结尾 / const path = cfg.API?.OPENAPI || '/openapi.json' // 默认值兜底 const specUrl = base + path
这里写上路由：const specUrl = "http://ip:port/openai.json"
6.npm run dev启动
访问本地index.js里的路由访问vue，正常显示

高版本3.10降级方案：
写到fastapi main.py里
def custom_openapi():
# 命中缓存直接返回
if app.openapi_schema:
return app.openapi_schema
# 用 FastAPI 原生逻辑生成 schema（路由、参数、模型全部自动收集）
openapi_schema = get_openapi(
title=app.title,
version=app.version,
description=app.description,
routes=app.routes,
)
# ← 关键：把 3.1.0 降成 3.0.3，兼容老 swagger-ui
openapi_schema["openapi"] = "3.0.3"
# 顺带清理 3.1 里 swagger-ui 不认的字段（防止个别组件仍报错）
openapi_schema.pop("webhooks", None)
for path_item in openapi_schema.get("paths", {}).values():
for op in path_item.values():
if isinstance(op, dict):
op.pop("webhooks", None)
app.openapi_schema = openapi_schema
return app.openapi_schema
# 覆盖 FastAPI 默认的 openapi 生成方法
app.openapi = custom_openapi

高版本报错，改main.py

ht拆开tps://github.com/D-S自己删henMuFeng/ShenFengPlublicFile
资料可以在github库自取，已打包成dist,config.js改一下路径，nginx指一下挂在前端即可

在git的simple.html里有本地替代版，进去找一下路径给localhost:8000改成你的后端路径即可
什么都不用了，只要xxx:xx/openapi.json的路由能请求成功就可以

直接ai啊，让它帮你搞