如何用Axum/Tower压缩HTML内容？本地测试未生效排查

1. 确认CompressionLayer的挂载顺序 #

Axum中间件按从后往前的顺序执行，CompressionLayer必须挂载在路由逻辑的外层（也就是先添加中间件，再注册路由）。如果挂载顺序颠倒，请求不会经过压缩中间件。

正确示例：

use axum::{Router, routing::get};
use tower_http::compression::{CompressionLayer, CompressionLevel};

async fn hello() -> &'static str {
    "<html><body><h1>Hello World</h1></body></html>"
}

#[tokio::main]
async fn main() {
    let app = Router::new()
        .route("/", get(hello))
        // 先添加压缩中间件，再绑定路由
        .layer(CompressionLayer::new()
            .gzip(true)
            .deflate(true)
            .br(true)
            .zstd(true)
            .compression_level(CompressionLevel::Fast));

    lambda_http::run(app.into_make_service()).await.unwrap();
}

2. 确保响应Content-Type符合压缩条件 #

CompressionLayer默认只压缩可压缩MIME类型（如text/html、application/json），如果响应未正确设置Content-Type，中间件会跳过压缩。

返回HTML时，推荐使用Axum的Html类型自动设置头：

use axum::response::Html;

async fn hello() -> Html<&'static str> {
    Html("<html><body><h1>Hello World</h1></body></html>")
}

手动构建响应时需显式添加头：

use axum::http::{HeaderValue, Response};
use axum::body::Body;

async fn hello() -> Response<Body> {
    let mut resp = Response::new(Body::from("<html><body><h1>Hello World</h1></body></html>"));
    resp.headers_mut().insert(
        axum::http::header::CONTENT_TYPE,
        HeaderValue::from_static("text/html; charset=utf-8"),
    );
    resp
}

3. 验证cargo lambda是否正确转发请求头 #

cargo lambda的invoke命令可能模拟Lambda事件而非标准HTTP请求，导致Accept-Encoding头丢失。建议直接请求本地服务端口（默认9000）：

curl -H "Accept-Encoding: gzip, deflate, br, zstd" http://localhost:9000/ -v

同时可在处理函数中打印请求头，确认是否收到：

use axum::extract::HeaderMap;
use axum::response::Html;

async fn hello(headers: HeaderMap) -> Html<&'static str> {
    println!("Accept-Encoding: {:?}", headers.get("accept-encoding"));
    Html("<html><body><h1>Hello World</h1></body></html>")
}

4. 检查依赖版本兼容性 #

Axum 0.7要求tower-http版本≥0.5.0，且需启用对应压缩算法的features。确保Cargo.toml配置正确：

[dependencies]
axum = "0.7"
lambda_http = "0.9"
tower-http = { version = "0.5", features = ["compression", "compression-gzip", "compression-deflate", "compression-br", "compression-zstd"] }
tokio = { version = "1.0", features = ["full"] }

5. 调整响应体压缩阈值 #

CompressionLayer默认跳过小于1024字节的响应体，若你的HTML内容过短，可强制压缩所有响应：

.layer(CompressionLayer::new()
    .min_response_size(0)
    .gzip(true)
    .deflate(true)
    .br(true)
    .zstd(true))

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