Nuxt静态站点能否启用gzip压缩？.htaccess配置后资源未编码

致命语法错误（直接导致整份.htaccess失效） #

原配置中的gzip重写规则行存在无标识注释问题，错误写法示例如下：

RewriteRule ^(.+) $1.gz Apache for recompressing the files

这行没有给注释加#前缀，Apache解析时会把后续的“Apace for recompressing the files”全部当成规则的标志位参数，直接触发语法校验失败，导致整份.htaccess的规则全部被跳过执行。

前置生效条件检查 #

• 确认Apache已启用mod_rewrite、mod_headers、mod_mime模块，否则对应规则逻辑不会执行。
• 确认站点对应目录的AllowOverride配置不是None，否则.htaccess文件会被Apache完全忽略，不会被读取。
• 确认和静态文件同路径下存在预压缩实体文件，比如请求/style/main.css时，对应服务器路径下必须存在/style/main.css.gz、/style/main.css.br实体文件，否则压缩判断条件会不满足。

原配置的逻辑缺陷 #

• 规则执行顺序错误：压缩资源的重写逻辑必须放在MIME类型匹配规则之前，否则请求没有被重写到对应.gz/.br路径时，后续的文件类型判断逻辑根本不会触发。
• 缺失brotli格式的重写分支：原配置只写了br压缩文件的响应头规则，没有写根据Accept-Encoding匹配br预压缩文件的重写逻辑，导致支持br编码的浏览器无法拿到对应压缩资源。
• 规则未做模块包裹校验：没有用<IfModule>包裹依赖特定模块的规则，一旦对应模块未启用，会触发语法报错，导致整份配置失效。
• 缺少内置压缩屏蔽逻辑：没有在返回预压缩资源时禁用Apache自带的mod_deflate压缩过滤，会导致已压缩的资源被二次压缩，出现编码错乱。

修正后可直接使用的配置 #

<IfModule mod_rewrite.c>
  RewriteEngine On
  # 优先匹配支持度更高的brotli预压缩文件
  RewriteCond %{HTTP:Accept-Encoding} br
  RewriteCond %{REQUEST_URI} \.(css|html|js)$
  RewriteCond %{REQUEST_FILENAME}.br -s
  RewriteRule ^(.+) $1.br [L]
  # 匹配gzip预压缩文件
  RewriteCond %{HTTP:Accept-Encoding} gzip
  RewriteCond %{REQUEST_URI} \.(css|html|js)$
  RewriteCond %{REQUEST_FILENAME}.gz -s
  RewriteRule ^(.+) $1.gz [L]
  # 为重写后的压缩文件绑定对应原资源的MIME类型，禁用内置压缩
  RewriteRule "\.css\.br$" "-" [T=text/css,E=no-brotli,E=no-gzip]
  RewriteRule "\.css\.gz$" "-" [T=text/css,E=no-brotli,E=no-gzip]
  RewriteRule "\.html\.br$" "-" [T=text/html,E=no-brotli,E=no-gzip]
  RewriteRule "\.html\.gz$" "-" [T=text/html,E=no-brotli,E=no-gzip]
  RewriteRule "\.js\.br$" "-" [T=application/javascript,E=no-brotli,E=no-gzip]
  RewriteRule "\.js\.gz$" "-" [T=application/javascript,E=no-brotli,E=no-gzip]
</IfModule>
<IfModule mod_headers.c>
  <FilesMatch "\.(css|html|js)\.br$">
     Header set Content-Encoding br
     Header append Vary Accept-Encoding
  </FilesMatch>
  <FilesMatch "\.(css|html|js)\.gz$">
     Header set Content-Encoding gzip
     Header append Vary Accept-Encoding
  </FilesMatch>
</IfModule>

验证方法 #

• 发送带指定编码头的请求，检查返回头是否正确携带Content-Encoding字段，返回的资源是否为对应压缩文件的二进制内容。
• 查看Apache错误日志，排查是否存在规则语法报错、文件权限不足等问题。

内容的提问来源于stack exchange，提问作者Azxvrghx