Rust Actix Web搭配Nginx HTTPS代理时请求解析错误排查

核心问题分析 #

你遇到的invalid Header provided错误，大概率是Nginx与Actix Web之间的协议不匹配导致的。Nginx配置中启用了http2监听，但转发请求时未明确指定与Actix兼容的HTTP版本，导致Actix的HTTP/1.1解析器收到了二进制的HTTP/2帧，无法正常解析为请求头。

另外，既然已经用Nginx处理SSL/TLS，Actix Web完全不需要额外配置HTTPS，保持当前的纯HTTP服务即可。

具体修复步骤 #

1. 修正Nginx转发的HTTP版本 #

在Nginx的location /myserver/块中添加proxy_http_version 1.1;，强制Nginx使用HTTP/1.1与Actix通信，避免HTTP/2协议不兼容问题：

location /myserver/ {
    proxy_http_version 1.1; # 添加这行
    proxy_pass_header Server;
    proxy_set_header Host $http_host;
    proxy_redirect off;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Scheme $scheme;
    proxy_pass http://myserver:4000/;
}

2. 可选：补充HTTP/1.1兼容配置 #

如果上述修复无效，可添加proxy_set_header Connection "";，适配HTTP/1.1的连接头规则：

location /myserver/ {
    proxy_http_version 1.1;
    proxy_set_header Connection ""; # 添加这行
    # 其余配置保持不变
}

额外排查方向 #

打印请求头验证 #

你计划编写中间件打印请求头的思路可行，以下是一个简单的Actix Web中间件示例，用于输出所有请求头，帮助定位是否存在非法头：

use actix_web::{dev::Service, middleware::Logger, web, App, HttpServer, HttpRequest, HttpResponse};
use futures::future::FutureExt;

// 自定义打印请求头的中间件
fn log_request_headers<S>(service: S) -> impl Service<Request = HttpRequest, Response = S::Response, Error = S::Error>
where
    S: Service<Request = HttpRequest, Response = HttpResponse, Error = actix_web::Error>,
{
    service.map_request(|req| {
        println!("Received request headers:");
        for (name, value) in req.headers() {
            println!("{}: {:?}", name, value);
        }
        req
    })
}

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    HttpServer::new(move || {
        App::new()
            .wrap(Logger::default())
            .wrap(log_request_headers) // 添加自定义中间件
            .wrap(Cors::default().allow_any_header().supports_credentials())
            .service(test_index)
    })
    .workers(4)
    .bind(("0.0.0.0", 4000))?
    .run()
    .await
}

运行后查看Actix日志，检查是否存在不符合HTTP规范的头（比如头名包含非ASCII字符、空格等）。

检查Docker网络配置 #

确保Docker Compose中Nginx通过内部网络访问Actix容器，而非将Actix的4000端口直接映射到宿主机——避免外部HTTPS请求直接打到Actix的HTTP服务上，导致协议不兼容。

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