Node.js Express服务器压缩功能失效问题排查求助

1. 确认compression中间件的加载顺序 #

Express中间件按执行顺序生效，compression必须放在静态资源托管（如express.static）和路由配置之前，否则静态资源请求不会经过压缩处理。示例正确配置顺序：

const compression = require('compression');
const express = require('express');
const app = express();

// 优先加载compression中间件
app.use(compression({
  // 调试期间可先注释自定义shouldCompress，用默认逻辑测试
  shouldCompress: (req, res) => {
    if (req.headers['x-no-compression']) {
      return false;
    }
    // 保留默认判断逻辑，避免误过滤JS文件
    return compression.filter(req, res);
  }
}));

// 再配置静态资源托管
app.use(express.static('public'));

// 最后设置路由
app.get('/', (req, res) => {
  res.send('Hello World');
});

2. 排查自定义shouldCompress函数逻辑 #

多数情况下问题出在自定义过滤规则上：

• 检查函数是否错误返回false，导致three.module.min.js被排除在压缩范围外
• 临时注释自定义shouldCompress，用默认配置测试，如果压缩生效，再逐步调试你的过滤逻辑

3. 用curl验证压缩是否生效 #

通过命令行直接测试响应头，确认服务器是否正确处理压缩：

curl -H "Accept-Encoding: gzip" -I http://你的域名/three.module.min.js

如果压缩正常，响应头会包含Content-Encoding: gzip，且Content-Length数值远小于原文件大小（630.3 KiB）。

4. 禁止手动设置Content-Encoding #

你手动添加该响应头但服务器未实际压缩内容，浏览器会尝试用gzip解码原始未压缩JS，必然触发net::ERR_CONTENT_DECODING_FAILED错误。压缩逻辑必须交给compression中间件自动处理，它会负责同时完成内容压缩和响应头设置。

5. 排除预压缩文件冲突 #

如果之前手动生成过.gz或.br格式的预压缩文件，确保express.static没有优先返回这些文件，或者临时移除预压缩文件测试，避免和compression中间件的动态压缩逻辑冲突。

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