关键在于root正确定位资源路径、gzip_static on在静态location块中启用、构建阶段产出同名.gz文件三者缺一不可；root仅映射路径，gzip_static才查找并返回预压缩文件，二者需模块支持且协同兜底。
要让 Nginx 用 root 指令托管静态文件，同时自动返回预压缩的 .gz 文件（而非实时压缩），关键不是“root 配 gzip”，而是 root 正确定位资源路径 + gzip_static on 在正确作用域启用 + 构建阶段产出真实 .gz 文件。三者缺一不可。
确保 root 路径能准确拼出 .gz 文件的物理位置
root 本身不压缩、也不识别 .gz，它只负责把请求 URI 映射成磁盘路径。例如：
- 请求
/js/app.js，root /usr/share/nginx/html;→ 对应文件是/usr/share/nginx/html/js/app.js - 启用
gzip_static on后，Nginx 会额外查找/usr/share/nginx/html/js/app.js.gz
所以必须保证：源文件存在，且同名 .gz 文件也放在同一目录下，权限可读，修改时间（mtime）最好与源文件一致（可用 touch -r app.js app.js.gz 同步）。
在静态资源 location 块中启用 gzip_static
gzip_static on 必须写在具体服务静态文件的 location 块里，不能放在 http 或 server 顶层：
- ✅ 推荐写法（覆盖常见静态后缀）：
location ~* \.(js|css|svg|json|html|xml|ttf|woff2?)$ {
root /usr/share/nginx/html;
gzip_static on;
} - ❌ 错误写法：
http { gzip_static on; } → 语法错误，指令不在允许上下文
location / { root ...; try_files $uri $uri/ /index.html; gzip_static on; } → 可能因 try_files 重写路径导致 .gz 找不到
确认 Nginx 已编译支持 gzip_static 模块
该功能依赖独立模块 ngx_http_gzip_static_module，不是基础 gzip 的一部分。执行命令验证：
若无输出，说明模块缺失——apt/yum 安装的包、宝塔默认安装通常不含此模块，需重新编译 Nginx 并添加 --with-http_gzip_static_module 参数。
与常规 gzip 共存，各司其职
gzip_static 和 gzip on 可以（且推荐）同时启用，但分工明确：
-
gzip_static on：查到.js.gz就直接发，零 CPU 开销，优先级高于动态 gzip -
gzip on：作为兜底，处理未预压缩的文件、API 响应、PHP 输出等 - 二者互不干扰：
gzip_static不受gzip_types限制；gzip on仍需配置gzip_types text/html application/javascript...来保障兜底压缩有效
