如何在MAUI Android应用中启用或强制使用HTTP/2请求？

1. 强制MAUI Android客户端使用HTTP/2 #

gRPC原生依赖HTTP/2，但Android端的gRPC .NET客户端可能因环境或配置问题自动降级到HTTP/1.1，需要显式配置强制HTTP/2请求。在创建gRPC Channel时添加以下配置：

// 配置HTTP Handler强制HTTP/2
var httpHandler = new SocketsHttpHandler
{
    EnableMultipleHttp2Connections = true,
    SslOptions = new SslClientAuthenticationOptions
    {
        // 确保使用支持HTTP/2的TLS版本
        SslProtocols = SslProtocols.Tls12 | SslProtocols.Tls13
    }
};

// 创建指定HTTP/2的gRPC Channel
var channel = GrpcChannel.ForAddress("https://你的服务器地址", new GrpcChannelOptions
{
    HttpHandler = httpHandler,
    HttpVersion = HttpVersion.Version20,
    HttpVersionPolicy = HttpVersionPolicy.RequestHttp2OrHigher
});

2. 确认Kestrel服务器配置有效性 #

即使你已设置允许HTTP/1和HTTP/2，仍需验证配置是否正确生效，且gRPC必须依赖HTTPS（本地明文HTTP/2除外）：

// Program.cs中Kestrel配置示例
builder.WebHost.ConfigureKestrel(options =>
{
    options.ListenAnyIP(5001, listenOptions =>
    {
        listenOptions.Protocols = HttpProtocols.Http1AndHttp2;
        // 必须启用HTTPS，否则HTTP/2无法正常工作
        listenOptions.UseHttps("你的证书路径", "证书密码");
    });
});

3. 认证相关排查 #

若服务启用了认证（如JWT、证书），需确保客户端认证信息传递方式正确，避免因认证失败导致请求协议降级：

// 添加Bearer Token认证示例
var authCredentials = CallCredentials.FromInterceptor((context, metadata) =>
{
    metadata.Add("Authorization", $"Bearer {你的Token}");
    return Task.CompletedTask;
});

// 结合SSL认证和自定义认证创建Channel
var channelCredentials = ChannelCredentials.Create(new SslCredentials(), authCredentials);
var channel = GrpcChannel.ForAddress("https://你的服务器地址", new GrpcChannelOptions
{
    Credentials = channelCredentials,
    // 加上前面的HTTP/2强制配置
    HttpHandler = httpHandler,
    HttpVersion = HttpVersion.Version20,
    HttpVersionPolicy = HttpVersionPolicy.RequestHttp2OrHigher
});

4. 额外注意事项 #

• 确保Android设备系统版本在7.0（API 24）及以上，该版本开始原生支持HTTP/2；
• 若使用本地测试的明文HTTP/2，需在AndroidManifest.xml中添加android:usesCleartextTraffic="true"，但生产环境不建议这么做。

内容的提问来源于stack exchange，提问作者Álvaro García