nginx 适配移动端弱网需围绕“传输快、解压快、缓存稳、断连不崩”设计：启用 http/3+quic（含 0-rtt 和连接迁移）、哈希化静态资源配 immutable 长缓存、brotli 按类型调参（如 html/css/js 用 level 5）。
要在 Nginx 中真正适配移动端弱网环境，不能只堆参数，得围绕“传输快、解压快、缓存稳、断连不崩”四个核心来设计。重点不是让所有请求都缓存，而是让关键资源传得准、加载得快、更新得对、失败时有兜底。
用 HTTP/3 + QUIC 降低握手与重传开销
弱网下 TCP 的队头阻塞和重传机制是首屏慢的主因。HTTP/3 基于 QUIC 能实现 0-RTT 连接恢复和连接迁移，对地铁进出站、Wi-Fi 切换等场景效果显著：
- 确认 Nginx 编译含
--with-http_v3_module和--with-stream_quic_module，内核 ≥ 5.4（推荐 5.7+） - 监听配置必须同时启用 TCP 与 UDP：
listen 443 ssl http2;listen 443 quic reuseport; - 强制 TLS 1.3：
ssl_protocols TLSv1.3;，并添加发现头：add_header Alt-Svc 'h3=":443"; ma=86400'; - 开启 UDP GSO（内核 ≥ 5.6）：
quic_gso on;，提升高丢包率下的吞吐稳定性
静态资源：哈希化 + immutable 长期缓存
移动端浏览器时钟不准、WebView 缓存策略不一，Expires 指令极易失效。必须统一用 Cache-Control，并配合构建层文件名哈希：
- JS/CSS/字体/图片等稳定资源，匹配带哈希的路径：
location ~* "\.[a-f0-9]{8,}\.(js|css|woff2|png|jpg)$" {<br> add_header Cache-Control "public, max-age=31536000, immutable" always;<br>} - 禁止使用
?v=1.2.3类查询参数——微信、部分安卓 WebView 会忽略参数变化，仍读旧缓存 - 对 SVG 或图标字体等低频更新资源，可追加
stale-while-revalidate：Cache-Control: public, max-age=31536000, stale-while-revalidate=86400
Brotli 压缩：按内容类型调参，兼顾体积与解压效率
弱网下体积敏感，但移动端 CPU 解压能力有限。Brotli 不是“开就完事”，要分资源类型精细控制：
- HTML/CSS/JS 主文档用
brotli_comp_level 5：压缩率提升约 19%，主流机型解压 100KB - JSON 接口响应用
brotli_comp_level 4：小文件收益明显，避免后端高压缩拖慢吞吐 - 窗口大小设为
brotli_window 18（256KB）：匹配 HTML 模板中跨段重复结构，避免内存过载或查重不足 - 启用预压缩与静态字典：
brotli_static on;，配合构建阶段生成.br文件，跳过运行时压缩
HTML 与动态接口：禁强缓存 + 协商验证 + 断连防护
入口 HTML 必须可及时更新，API 在弱网易中断，这两类需特殊处理：
- HTML 文件禁用
expires，统一用：add_header Cache-Control "private, max-age=0, no-cache, must-revalidate";
并确保后端返回稳定 ETag（关闭 gzip 差异导致的 ETag 变化） - 长耗时 API（如报表生成）启用
proxy_ignore_client_abort on;，同时配好超时：proxy_read_timeout 300;，proxy_buffering off;，proxy_http_version 1.1; - 高频稳定接口（如商品详情）启用反向代理缓存：
proxy_cache_valid 200 302 10m;proxy_cache_use_stale error timeout updating;，避免雪崩
