使用axum与tonic搭建gRPC-Web Rust服务器遇类型匹配等问题

1. 修复路由类型不匹配错误 #

类型不匹配的核心原因是axum默认Router的错误类型为Infallible，但tonic服务返回的错误是Box<dyn Error + Send + Sync>，需要通过路由分离和中间件配置来统一类型。

修改后的可运行main.rs示例：

use axum::{
    routing::get,
    Router, Server,
};
use std::net::SocketAddr;
use tonic_web::GrpcWebLayer;
use tower_http::cors::{Any, CorsLayer};

mod grpc; // 你的gRPC服务生成模块

async fn main() {
    // 配置CORS：gRPC-Web浏览器客户端需要OPTIONS预检请求支持
    let cors = CorsLayer::new()
        .allow_origin(Any)
        .allow_methods(Any)
        .allow_headers(Any);

    // 拆分路由，隔离HTTP和gRPC服务的错误类型
    let http_router = Router::new()
        .route("/api", get(|| async { "Hello, World!" }));

    let grpc_router = Router::new()
        .route_service(
            "/*rpc",
            // 给tonic服务添加gRPC-Web协议转换中间件，并转为axum兼容服务
            grpc::new_grpc_server()
                .layer(GrpcWebLayer::new())
                .into_service(),
        )
        .layer(cors);

    // 合并路由
    let api = http_router.merge(grpc_router);

    let addr = SocketAddr::from(([0, 0, 0, 0], 3000));
    Server::bind(&addr)
        .serve(api.into_make_service())
        .await
        .unwrap();
}

关键修复点：

• 用merge拆分HTTP和gRPC路由，避免错误类型冲突
• 给tonic服务绑定GrpcWebLayer，完成gRPC到gRPC-Web的协议转换
• 添加CORS中间件处理浏览器预检请求

2. 是否必须使用axum::routing::any_service？ #

不是必须的。

• 标准gRPC仅使用POST方法，可直接用post_service绑定；
• any_service或route_service更通用，能自动适配gRPC-Web所需的OPTIONS请求（用于CORS预检），因此推荐使用route_service（axum 0.7+官方推荐）。

3. 用tonic-web暴露gRPC-Web服务的步骤 #

1. 添加依赖：在Cargo.toml中补充：

tonic-web = "0.10"
tower-http = { version = "0.5", features = ["cors"] }

2. 包裹tonic服务：用GrpcWebLayer::new()包裹你的tonic服务器实例，完成协议转换（支持HTTP/1.1、JSON/Protobuf编码）；
3. 配置CORS：通过tower_http::cors::CorsLayer允许跨域请求的来源、方法和头，适配浏览器端gRPC-Web客户端的预检要求；
4. 绑定到axum路由：将转换后的服务通过route_service或merge添加到axum路由中。

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