nginx层优化可将500ms接口降至50ms以下，核心是分层击破连接复用、缓存、超时和传输四环节：启用keepalive减少握手开销；对无用户态get接口配置proxy_cache提升响应速度；合理设置connect/send/read超时避免卡点；结合gzip、http/2及精简头字段降低传输负担。
直接在 Nginx 层做针对性优化，是降低 API 响应时间最高效的方式之一——不改后端代码，就能把 500ms 的接口压到 50ms 甚至更低。关键不是堆参数，而是分层击破连接、转发、缓存和超时这四个核心环节。
复用连接，减少握手开销
每次新建 TCP 连接都要三次握手，对高频 API 来说开销明显。启用 keepalive 能让客户端和 Nginx、Nginx 和后端都复用连接：
- 前端到 Nginx：设 keepalive_timeout 15–25 秒（纯 JSON API 场景），配合 keepalive_requests 100–500，避免单连接长期占用
- Nginx 到后端：upstream 块中加 keepalive 32，并确保 proxy_http_version 1.1 和 proxy_set_header Connection ''
- 注意上下游对齐：若前有云负载均衡（如阿里云 SLB），其 idle timeout 通常为 60 秒，Nginx 的 keepalive_timeout 应设为 ≤55 秒，否则连接会被静默断开
缓存可复用的响应结果
对读多写少、无用户态、纯 GET 的 API（比如配置下发、词典查询、翻译短语），Nginx 缓存能将响应从 200ms+ 降到 5–20ms：
- 定义缓存区：proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=api_cache:10m max_size=1g inactive=60m use_temp_path=off
- 在 location 中启用：proxy_cache api_cache，并用 proxy_cache_valid 200 302 10m 控制缓存时长
- 精准构造 cache key：proxy_cache_key "$scheme$request_method$host$uri$is_args$args"，避免带 session 或时间戳的请求污染缓存
- 处理 stale 场景：proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504，保证降级可用
调优超时参数，避免卡点等待
API 超时往往不是单一参数问题，而是链路中某环被卡住。需按环节分别设限：
- proxy_connect_timeout 5–10s：控制建连阶段，网络抖动或后端宕机时快速失败
- proxy_send_timeout 10–30s：适用于大 body 提交，防止上传卡死
- proxy_read_timeout 30–120s：针对后端耗时逻辑（如报表导出），但要配合业务预期，不宜盲目拉长
- send_timeout 60s：客户端侧响应发送超时，尤其注意移动端弱网下小包重传场景
- 跨域请求务必检查 OPTIONS 预检是否快速返回（建议 return 204），否则主请求根本不会发出
压缩与协议升级，减小传输负担
响应体越小、协议越新，传输耗时越低：
- 开启 gzip：gzip on; gzip_types application/json text/plain application/javascript;
- 启用 HTTP/2：listen 443 ssl http2;，支持多路复用，避免队头阻塞
- 调小缓冲区避免延迟：client_body_buffer_size 128k;、proxy_buffering off;（对流式响应如 SSE 更有效）
- 禁用不必要的头字段：etag off; if_modified_since off;，减少计算与比对开销
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
