当前位置：首页 > 文章列表 > 文章 > java教程 > Java启用GZIP压缩输出方法详解

Java启用GZIP压缩输出方法详解

2025-07-28 11:00:45 0浏览收藏

在Java Web应用中，启用GZIP/Deflate压缩是提升网络性能的关键手段。本文详细介绍了三种主流的Java GZIP压缩输出方法，助力优化网站速度。首先，通过修改Servlet容器（如Tomcat）的`server.xml`文件，配置compression、compressionMinSize和compressableMimeType属性，实现服务器端的自动压缩。其次，介绍如何通过自定义Filter，灵活地在代码层面控制GZIP压缩逻辑，并提供详细的Java代码示例。最后，阐述在Spring Boot项目中，如何通过简单的配置文件，快速启用GZIP压缩功能。同时，本文还深入探讨了compressionMinSize的设置原因，以及GZIP与Deflate的区别，并介绍了Brotli等更先进的压缩算法，帮助开发者选择最适合的压缩方案，提升用户体验。

在Java Web应用中启用GZIP压缩主要有三种方式：1. 在Servlet容器（如Tomcat）的server.xml中配置compression、compressionMinSize和compressableMimeType属性；2. 通过自定义Filter实现，在Filter中检查客户端是否支持GZIP，若支持则使用GZIPOutputStream包装响应输出流，并设置Content-Encoding头；3. 在Spring Boot中通过配置文件启用，设置server.compression.enabled为true，并指定MIME类型和最小响应大小。此外，压缩小文件可能增加CPU负担，因此需设置compressionMinSize以优化性能；验证可通过浏览器开发者工具查看响应头是否包含Content-Encoding: gzip；相比Deflate，GZIP更常见且浏览器支持更好，而Brotli压缩率更高但需额外配置。

如何在Java中进行网络响应压缩 Java启用GZIP或Deflate压缩输出

Java中启用网络响应压缩，主要是为了减少数据传输量，提高网络性能。通常采用GZIP或Deflate算法。

启用GZIP或Deflate压缩，本质上是在服务器端对响应数据进行压缩，然后在客户端（浏览器）解压。

如何在Java Web应用中启用GZIP压缩？

启用GZIP压缩，通常是在Servlet容器（如Tomcat, Jetty）层面配置，或者在Java代码中通过Filter实现。

1. Servlet容器配置 (以Tomcat为例):

修改Tomcat的server.xml文件，在标签中添加或修改compression、compressableMimeType等属性。

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

compression="on"：启用压缩。
compressionMinSize="2048"：只有响应大小超过2048字节时才进行压缩。这是一个性能优化，因为压缩小文件可能会增加CPU负担，反而降低性能。
compressableMimeType：指定哪些MIME类型的文件可以被压缩。务必包含常用的文本类型，如HTML、CSS、JavaScript、JSON等。

2. 通过Filter实现:

这种方式更灵活，可以在代码层面控制压缩逻辑。

import java.io.IOException;
import java.io.OutputStream;
import java.util.zip.GZIPOutputStream;
import javax.servlet.Filter;
import javax.servlet.FilterChain;
import javax.servlet.FilterConfig;
import javax.servlet.ServletException;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class GZIPFilter implements Filter {

    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        // 初始化，可以读取Filter的配置参数
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {

        HttpServletRequest httpRequest = (HttpServletRequest) request;
        HttpServletResponse httpResponse = (HttpServletResponse) response;

        String ae = httpRequest.getHeader("accept-encoding");
        if (ae != null && ae.contains("gzip")) {
            GZIPResponseWrapper wrappedResponse = new GZIPResponseWrapper(httpResponse);
            chain.doFilter(request, wrappedResponse);
            wrappedResponse.finish();
            return;
        }

        chain.doFilter(request, response);
    }

    @Override
    public void destroy() {
        // 销毁，释放资源
    }
}

class GZIPResponseWrapper extends HttpServletResponseWrapper {
    private GZIPOutputStream gzipOutputStream = null;
    private ServletOutputStream servletOutputStream = null;

    public GZIPResponseWrapper(HttpServletResponse response) throws IOException {
        super(response);
    }

    @Override
    public ServletOutputStream getOutputStream() throws IOException {
        if (servletOutputStream == null) {
            gzipOutputStream = new GZIPOutputStream(getResponse().getOutputStream());
            servletOutputStream = new ServletOutputStreamWrapper(gzipOutputStream);
        }
        return servletOutputStream;
    }

    @Override
    public void setContentLength(int len) {
        // Ignore, since content length of zipped content
        // is not known in advance.
    }

    public void finish() throws IOException {
        if (gzipOutputStream != null) {
            gzipOutputStream.finish();
        }
    }
}

class ServletOutputStreamWrapper extends ServletOutputStream {
    private OutputStream output;

    public ServletOutputStreamWrapper(OutputStream output) {
        this.output = output;
    }

    @Override
    public void write(int b) throws IOException {
        output.write(b);
    }

    @Override
    public void flush() throws IOException {
        output.flush();
    }

    @Override
    public void close() throws IOException {
        output.close();
    }

    @Override
    public boolean isReady() {
        return true; // 始终返回true
    }

    @Override
    public void setWriteListener(WriteListener writeListener) {
        // 忽略
    }
}

需要在web.xml中配置这个Filter：

<filter>
    <filter-name>GZIPFilter</filter-name>
    <filter-class>com.example.GZIPFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>GZIPFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

这个Filter的核心逻辑是：

检查请求头Accept-Encoding是否包含gzip，表示客户端支持GZIP。
如果是，则创建一个GZIPResponseWrapper，包装HttpServletResponse。
在GZIPResponseWrapper中，重写getOutputStream()方法，返回一个GZIPOutputStream，所有写入到response的数据都会被GZIP压缩。
设置响应头Content-Encoding: gzip，告诉客户端响应是GZIP压缩的。

3. Spring Boot中的配置:

Spring Boot提供了更简洁的方式来启用GZIP压缩。可以在application.properties或application.yml中配置：

server.compression.enabled=true
server.compression.mime-types=text/html,text/xml,text/plain,text/css,text/javascript,application/javascript,application/json
server.compression.min-response-size=2048

或者使用YAML格式：

server:
  compression:
    enabled: true
    mime-types: text/html,text/xml,text/plain,text/css,text/javascript,application/javascript,application/json
    min-response-size: 2048

这些配置项和Tomcat的server.xml中的属性含义相同。Spring Boot会自动配置相应的Filter来实现GZIP压缩。