总体思路
将 Swagger/OpenAPI 视为应用交付链路中的一环，性能提升应聚焦在：文档与 UI 的加载与渲染、后端生成与接口响应、反向代理与传输、运行时资源与监控四个层面。下面给出在 Ubuntu 环境下的可落地做法与优先级。
一 文档与 UI 层优化
- 启用 HTTP 缓存与强缓存：为 /swagger-ui/、/swagger.json 等静态资源设置 Cache-Control: public, max-age，对不常变更的 OpenAPI JSON 使用 ETag/Last-Modified 协商缓存，显著降低重复渲染与重复解析开销。
- 精简与按需加载：仅暴露必要的 API 分组/路径，关闭不必要的 defaultModelsExpandDepth、defaultModelExpandDepth、operationsSorter 等 UI 展开与排序，减少前端初始化计算。
- 使用独立静态站点托管：将 Swagger UI/Editor 通过 Nginx 直接托管静态文件，与应用服务解耦，减少后端在文档渲染上的资源占用。
- 启用压缩：在 Nginx 开启 gzip/brotli，压缩 HTML/CSS/JS/JSON，缩短首屏与规范下载时间。
- 按需加载与懒初始化：对大型规范启用按需加载与懒渲染策略，避免一次性解析过大的 OpenAPI 文档。
- 安全与性能并重：启用 HTTPS/TLS，现代 TLS 实现开销已显著降低，同时避免明文带来的额外重试与攻击面。
二 后端生成与接口响应优化
- 选择轻量集成：在 Spring Boot 场景优先使用 springdoc-openapi（OpenAPI 3），减少侵入性与初始化开销；按需配置 Docket/GroupedOpenApi 仅扫描必要包。
- 减少反射与模型膨胀：精简 DTO/VO，避免深层嵌套与重复 schema；关闭不必要的 @ApiModelProperty 示例与冗余注解，降低文档生成成本。
- 缓存 OpenAPI 规范：将生成的 OpenAPI JSON 缓存在内存（如 Caffeine）或 Redis，对频繁访问的文档端点设置长 TTL 与主动刷新，避免每次请求重新扫描与解析。
- 连接与线程池：使用高性能连接池（如 HikariCP），按 CPU/IO 调整 Tomcat/Jetty 线程池与超时，防止文档与业务请求互相抢占资源。
- 延迟初始化：仅在首次访问文档时初始化 Swagger 组件，或在低峰时段预热，降低应用启动与首访抖动。
- 接口侧性能：为文档中涉及的列表类接口启用 分页/过滤，减少单次返回数据量；对高频只读数据引入 Redis/Memcached 缓存，缩短响应时间。
三 反向代理与传输层优化
- 反向代理与静态资源分离：用 Nginx/HAProxy 承载 Swagger UI 静态资源与 API 转发，设置合适的 worker_processes/worker_connections，并开启 sendfile 与 tcp_nopush/tcp_nodelay。
- 压缩与缓存头：在代理层统一开启 gzip/brotli 与 Cache-Control/ETag，对 /swagger.json 设置较长 max-age 与 immutable。
- 连接复用与限流：启用 keepalive 与合理的 keepalive_requests，对文档与接口设置 rate limiting 与 burst，避免被压测或误操作拖垮。
- 传输安全与性能：全站启用 HTTPS/TLS 1.2+，优先 ECDHE 与 AES-GCM 套件，结合 HTTP/2 多路复用减少握手与队头阻塞。
四 运行时资源与监控
- JVM 与容器调优：对基于 JVM 的文档/网关服务，设置合理的 -Xms/-Xmx、选择合适的 GC（如 G1/ZGC），并开启 JMX 或 Micrometer 指标暴露以便观测。
- 系统层优化：适度降低 swappiness、优化 网络/文件句柄 与 内核网络缓冲区，为文档与代理进程预留足够资源。
- 监控与告警：使用 Prometheus + Grafana 采集 HTTP 延迟、吞吐、错误率、缓存命中率 等，结合日志定位文档生成与接口瓶颈。
- 扩展与弹性：在高峰期通过 水平扩展（多实例 + 负载均衡）分摊文档与接口流量，保障稳定性。
五 Ubuntu 快速落地清单
- 用 Nginx 托管 Swagger UI：将 dist 目录放到 /var/www/swagger-ui，配置强缓存与压缩；API 反向代理到后端。
- 配置缓存：为 /v3/api-docs 设置 ETag/Last-Modified 与 Cache-Control: public, max-age=3600；在应用内以 Caffeine/Redis 缓存规范。
- Spring Boot 项目：引入 springdoc-openapi-starter-webmvc-ui，按需分组，关闭不必要的模型展开与默认响应消息，减少初始化与渲染成本。
- JVM 与连接池：设置 -Xms/-Xmx（如 -Xms512m -Xmx1g）、选择 G1 GC，使用 HikariCP 并合理设置连接数/超时。
- 监控与压测：暴露 /actuator/prometheus，用 Prometheus/Grafana 建面板；用 ab/wrk 对 /swagger.json 与关键接口做基线压测并回归验证。
