如何在Tomcat中配置压缩

Tomcat启用HTTP响应压缩的实用指南

一 连接器级别配置 server.xml

• 位置与方式：编辑 $CATALINA_HOME/conf/server.xml，在用于HTTP的 上添加压缩相关属性并重启实例。Tomcat 自 5.0+ 支持输出压缩。示例：

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000" redirectPort="8443"
           compression="on"
           compressionMinSize="2048"
           noCompressionUserAgents="gozilla, traviata"
           compressableMimeType="text/html,text/xml,text/plain,text/css,application/json,application/javascript,application/xml" />

• 关键参数说明：
  • compression：开启/关闭压缩，常用值为 on/off，也可设为 force（强制压缩，忽略客户端 Accept-Encoding）。
  • compressionMinSize：触发压缩的最小响应体大小，单位字节；默认 2048（约 2KB），可按场景下调（如 1024）或上调以减少CPU开销。
  • compressableMimeType：指定可压缩的 MIME 类型（文本类为主，如 HTML/CSS/JS/JSON/XML）。
  • noCompressionUserAgents：指定不做压缩的 User-Agent 列表（历史/兼容性场景）。
  • compressionAlgorithm：指定算法 gzip/deflate（默认通常为 gzip）。

二 应用级压缩过滤器

• 适用场景：需要对特定 URL 路径、Content-Type 或 压缩级别 做细粒度控制时，在应用的 web.xml 中使用 Tomcat 提供的 CompressionFilter：

<filter>
  <filter-name>CompressionFilter</filter-name>
  <filter-class>org.apache.catalina.filters.CompressionFilter</filter-class>
  <init-param>
    <param-name>compressionLevel</param-name>
    <param-value>6</param-value> <!-- 1-9，6为通用平衡值 -->
  </init-param>
  <init-param>
    <param-name>noCompressionPattern</param-name>
    <param-value>^/(images|binary)/.*$</param-value> <!-- 正则排除路径 -->
  </init-param>
  <init-param>
    <param-name>compressionMimeTypes</param-name>
    <param-value>text/html,text/xml,text/plain,application/json,application/javascript,application/xml</param-value>
  </init-param>
</filter>
<filter-mapping>
  <filter-name>CompressionFilter</filter-name>
  <url-pattern>/*</url-pattern>
</filter-mapping>

• 提示：压缩级别越高（如 9）压缩率更好但 CPU 占用更高；通用业务建议 6，高并发API可考虑 1-3 以降低CPU压力。

三 验证与常见问题

• 如何验证
  • 响应头检查：查看响应是否包含 Content-Encoding: gzip 或 deflate。
  • 工具验证：使用浏览器开发者工具 Network 面板，或命令行如：
    • curl -H “Accept-Encoding: gzip,deflate” -I http://localhost:8080/your-path
• 常见问题与排查
  • 资源未压缩：检查 Content-Type 是否在 compressableMimeType 中；确认响应体大小是否达到 compressionMinSize；某些 User-Agent 可能被 noCompressionUserAgents 排除。
  • 静态文件压缩无效：若启用 sendfile（如 NIO 场景），可能绕过压缩，必要时设置 useSendfile=“false”。
  • 算法选择：默认 gzip 通常压缩率优于 deflate；如需兼容旧客户端可显式设置 compressionAlgorithm。

四 性能与最佳实践

• 压缩级别：优先使用 6；高并发/低延迟选 1-3；追求极致压缩且CPU充足再考虑 9。
• 阈值调优：将 compressionMinSize 设为 1024~2048 字节可在压缩率与CPU之间取得平衡；过小增加CPU，过大降低压缩收益。
• 静态资源预压缩：对不常变更的 JS/CSS/HTML 生成 .gz/.deflate 文件，配合 Tomcat/前端服务器直接提供预压缩内容，显著降低运行时压缩开销。
• 架构取舍：若前置 Nginx/Apache HTTP Server，可在反向代理层统一开启压缩，减少后端 Tomcat CPU 压力。