Xamarin.Forms gRPC客户端调用报Grpc.Core.RpcException异常问题咨询

错误触发原因 #

• 地址配置错误：代码中使用的https://localhost:5001指向本地回环地址，当Xamarin应用运行在安卓模拟器或真机上时，localhost指向的是移动设备本身，而非运行gRPC服务端的开发主机，无法找到对应服务，最终触发网络相关报错。
• 异常捕获逻辑错误：你将CreateSession调用代码写在了try块外部，调用抛出的异常不会被你编写的catch逻辑捕获，会直接触发应用层级的崩溃。
• 网络权限缺失：Xamarin.Android项目默认未开启网络访问权限，会直接拦截所有对外网络请求。
• 服务端绑定限制：如果gRPC服务端仅绑定了127.0.0.1/localhost地址，那么只有开发机本机可以访问服务，外部局域网设备无法连接。
• 平台兼容问题：Grpc.Net.Client在Xamarin平台下默认依赖的SocketsHttpHandler存在兼容问题，且同步调用在UI线程执行容易触发额外异常。

解决方案 #

1. 修正服务访问地址 #

• 将开发主机和运行Xamarin应用的设备连接到同一局域网，查询开发主机的局域网IP（例如192.168.3.25这类内网地址），将代码中的地址替换为https://<开发主机局域网IP>:5001。
• 如果使用安卓模拟器调试，可直接使用模拟器内置的开发主机映射地址10.0.2.2替代localhost，对应地址为https://10.0.2.2:5001。

2. 修正代码逻辑 #

调整异常捕获范围，将gRPC调用改为异步执行避免阻塞UI线程，参考代码如下：

private async void btnLogin_Clicked(object sender, EventArgs e)
{
    // 替换为实际的服务地址
    string url = "https://192.168.3.25:5001";

    try
    {
        using var channel = GrpcChannel.ForAddress(url);
        var client = new Session.SessionClient(channel);

        var response = await client.CreateSessionAsync(
            new CreateRequest
            {
                Utente = "{my user}",
                Password = "{my password}"
            });

        lblRequestResult.Text = $"UUID: {response.Uuid}";
    }
    catch (Exception ex)
    {
        lblRequestResult.Text = ex.Message;
    }
}

3. 配置网络权限 #

打开Xamarin.Android项目的Properties/AndroidManifest.xml文件，添加网络访问权限声明：

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

如果你的服务端使用HTTP协议而非HTTPS，还需要在AndroidManifest的application节点添加明文流量允许配置：

<application android:usesCleartextTraffic="true">
<!-- 其他配置 -->
</application>

4. 调整服务端配置 #

修改gRPC服务端的启动绑定地址，从localhost:5001改为0.0.0.0:5001，允许来自局域网内所有设备的访问请求。如果是ASP.NET Core实现的gRPC服务端，可在Program.cs中修改：

builder.WebHost.ConfigureKestrel(options =>
{
    options.ListenAnyIP(5001, o => o.UseHttps());
});

5. 适配Xamarin平台的gRPC客户端 #

如果修改上述配置后仍存在问题，可替换gRPC客户端实现：

• 卸载项目中的Grpc.Net.Client相关包，改用官方兼容Xamarin的Grpc.Core原生客户端包
• 若使用自签名HTTPS证书，调试阶段可暂时禁用证书校验，或者将证书导入到移动设备的信任证书列表中。

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