Xamarin.Forms Android项目gRPC客户端连接失败问题排查

两种实现方案无法正常工作，分别对应Xamarin平台gRPC开发的两个典型坑：

• 采用Grpc.Net.Client的方案无响应：Xamarin.Android默认使用Android原生AndroidClientHandler作为HttpClient底层实现，该实现不支持gRPC依赖的HTTP/2明文（h2c）协议，你设置的System.Net.Http.SocketsHttpHandler.Http2UnencryptedSupport开关仅对.NET内置的SocketsHttpHandler生效，默认配置下开关完全不生效，请求发出后会卡在协议协商阶段，没有后续响应。此外如果漏了Android网络权限、明文流量许可配置，也会直接导致请求被系统拦截。
• 采用Grpc.Core的方案抛空引用：Grpc.Core不是纯托管库，依赖C语言编写的原生核心库grpc_csharp_ext.so，如果仅在netstandard共享项目中安装NuGet包，Android项目不会自动引入对应CPU架构的原生库，初始化Channel时找不到原生函数入口就会直接抛出NullReferenceException。

优先推荐使用官方维护的Grpc.Net.Client方案，无原生库兼容问题，长期支持更好。

方案1：Grpc.Net.Client 实现步骤 #

1. 配置Android项目HttpClient底层

• 右键Xamarin.Android头项目→【属性】→【Android 选项】→【高级】
• 将HttpClient 实现项修改为System.Net.Http.SocketsHttpHandler
• 将SSL/TLS 实现项修改为Native TLS 1.2+

2. 配置Android网络权限
   打开Android项目下的Properties/AndroidManifest.xml，在根<manifest>节点下添加网络权限：

<uses-permission android:name="android.permission.INTERNET" />

针对Android 9.0（API 28）及以上版本，在<application>节点添加明文流量许可，否则HTTP明文请求会被系统直接拦截：

<application
   android:usesCleartextTraffic="true"
   ...其他配置>

3. 编写gRPC初始化与调用代码
   注意AppContext开关必须要在GrpcChannel初始化之前执行，建议放到Android项目MainActivity.OnCreate方法的最开头，同时显式指定Channel使用SocketsHttpHandler，避免被平台默认配置覆盖：

// 必须在GrpcChannel初始化前执行
AppContext.SetSwitch("System.Net.Http.SocketsHttpHandler.Http2UnencryptedSupport", true);

var channelOptions = new GrpcChannelOptions
{
    HttpHandler = new SocketsHttpHandler
    {
        // 测试环境可临时关闭证书校验，生产环境请勿开启
        ServerCertificateCustomValidationCallback = HttpClientHandler.DangerousAcceptAnyServerCertificateValidator
    }
};
var channel = GrpcChannel.ForAddress("http://10.8.130.47:50051", channelOptions);
var client = new Greeter.GreeterClient(channel);

调用接口时添加ConfigureAwait(false)避免同步上下文死锁，不要把网络调用直接写在页面构造函数里，放到页面生命周期方法中执行：

protected override async void OnAppearing()
{
    base.OnAppearing();
    Console.WriteLine("Entry Point");
    try
    {
        for (int i = 0; i < 10; i++)
        {
            var response = await client.SayHelloAsync(new HelloRequest { Name = "Xamarin Android" }).ConfigureAwait(false);
            Console.WriteLine($"Response received: {response.Message}");
            await Task.Delay(1000).ConfigureAwait(false);
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Call failed: {ex}");
    }
}

方案2：Grpc.Core 兼容实现步骤 #

如果需要兼容低于API 21的Android版本，可以使用Grpc.Core方案，注意做以下配置：

• 除了在netstandard共享项目安装Grpc.Core包，必须在Xamarin.Android头项目中也安装相同版本的Grpc.Core包，NuGet会自动将对应ABI的原生核心库打包进APK。
• 通道初始化代码放到Android原生环境加载完成后执行，不要过早放在共享项目的静态构造函数中：

  var channel = new Channel("10.8.130.47:50051", ChannelCredentials.Insecure);
  // 主动等待连接，设置5秒超时方便排查问题
  await channel.ConnectAsync(DateTime.UtcNow.AddSeconds(5));
  var client = new Greeter.GreeterClient(channel);
  

• 网络权限、明文流量许可配置和方案1完全一致。

在调试代码前先确认网络链路通畅：

• 服务端必须绑定0.0.0.0:50051地址，不能仅绑定localhost，否则同局域网设备无法访问。
• 关闭运行服务端的笔记本系统防火墙，或单独添加50051端口的入站规则。
• 用Android实体机自带浏览器访问http://10.8.130.47:50051，如果返回gRPC相关的错误提示（比如请求方法不支持），说明网络连通正常；如果无法打开网页，先排查网络和服务端配置，不要先调客户端代码。
• 尽量用实体机测试，Android模拟器默认NAT网络配置经常存在局域网访问限制，会干扰排查。

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