ASP.NET中使用HttpModule实现GZip或Deflate页面压缩

唐可

发布时间：2026-10-13| 4人浏览过

原创

本文介绍如何在ASP.NET应用中使用C#实现页面的动态压缩（GZip和Deflate）。通过继承接口，我们可以在BeginRequest事件中拦截HTTP响应，根据客户端支持的编码类型自动应用压缩算法，从而优化网络传输性能。

原理与准备条件

在.NET Framework及后续版本中，System.IO.Compression命名空间提供了用于数据压缩的两个核心类：GZipStream和DeflateStream。

实现页面压缩的关键逻辑如下：

检测客户端支持情况：通过读取请求头Accept-Encoding来判断浏览器是否支持gzip或deflate压缩。
替换输出流：获取当前的Response.Filter（即原始输出流），将其包装在压缩流中，使写入的数据被实时压缩。
通知客户端：在响应头中添加Content-Encoding，告知浏览器响应内容已压缩，需要解压后查看。

第1步：创建IHttpModule类

首先，创建一个实现接口的类。该模块将作为全局管道的一部分运行，处理所有传入的请求。

代码实现

using System;
using System.IO;
using System.IO.Compression;
using System.Web;

/// <summary>
/// 用于对HTTP响应进行GZip或Deflate压缩的模块
/// </summary>
public class GzipDeflate:IHttpModule
{
    public GzipDeflate()
    {
    }

    public void Init(HttpApplication app)
    {
        // 订阅BeginRequest事件，在请求开始时执行压缩逻辑
        app.BeginRequest += new EventHandler(app_BeginRequest);
    }

    void app_BeginRequest(object sender, EventArgs e)
    {
        HttpApplication app = (HttpApplication)sender;
        
        // 1. 获取客户端支持的编码方式
        string acceptEncoding = app.Request.Headers["Accept-Encoding"];
        if (string.IsNullOrEmpty(acceptEncoding)) return;

        acceptEncoding = acceptEncoding.ToLower();
        Stream requestStream = app.Response.Filter;

        // 2. 根据支持的编码类型替换Filter
        if (acceptEncoding.Contains("gzip"))
        {
            // 应用GZip压缩
            app.Response.Filter = new GZipStream(requestStream, CompressionMode.Compress);
            app.Response.AppendHeader("Content-Encoding", "gzip");
        }
        else if (acceptEncoding.Contains("deflate"))
        {
            // 应用Deflate压缩
            app.Response.Filter = new DeflateStream(requestStream, CompressionMode.Compress);
            app.Response.AppendHeader("Content-Encoding", "deflate");
        }
    }

    public void Dispose()
    {
        // 清理资源
    }
}

第2步：配置Web.config注册模块

为了让上述模块生效，需要在项目的web.config文件中进行配置。根据你的.NET版本，可能需要配置在不同的节点下。

.NET Framework < v4.0 的配置

在<system.web>节点下的<httpModules>中添加：

<system.web>
  <httpModules>
    <add name="GzipDeflate" type="YourNamespace.GzipDeflate" />
  </httpModules>
</system.web>

.NET Framework 4.0+ 的配置

推荐在<system.webServer>节点下的<modules>中添加：

<system.webServer>
  <modules>
    <add name="GzipDeflate" type="YourNamespace.GzipDeflate" preCondition="managedHandler" />
  </modules>
</system.webServer>

注意：请将YourNamespace替换为你项目中该类实际所在的命名空间名称。

完成判断与验证

部署代码后，可以通过浏览器开发者工具验证压缩是否生效：

打开浏览器的开发者工具（F12）。
切换到Network（网络）选项卡。
刷新页面，选中任意一个返回HTML资源的请求。
查看Headers（标头）中的Response Headers部分。
若看到Content-Encoding: gzip或Content-Encoding: deflate，且响应体积明显小于未压缩时的Content-Length，则说明压缩已成功应用。