Xamarin.Forms gRPC客户端连本地服务报failed to connect to all addresses怎么解决

核心问题根因 #

你遇到的连接失败主要由3类常见配置错误导致：

• 移动端运行环境的地址映射规则错误，比如安卓模拟器的127.0.0.1指向模拟器本身而非宿主机
• gRPC服务默认仅监听本地回环地址，局域网设备无法通过IP直接访问
• 移动端网络权限或明文访问限制未配置

分步解决步骤 #

1. 修正服务端监听配置 #

首先修改gRPC服务端的监听规则，不要仅绑定localhost，改为监听所有网卡地址，保证局域网设备可访问：

// ASP.NET Core服务Program.cs示例
builder.WebHost.ConfigureKestrel(options =>
{
    // 明文HTTP端口，仅用于开发测试
    options.ListenAnyIP(5000, o => o.Protocols = Microsoft.AspNetCore.Server.Kestrel.Core.HttpProtocols.Http2);
    // HTTPS端口
    options.ListenAnyIP(5001, o => 
    {
        o.Protocols = Microsoft.AspNetCore.Server.Kestrel.Core.HttpProtocols.Http2;
        o.UseHttps();
    });
});

配置完后先用BloomRPC连接你电脑的局域网IP:5000（比如你提到的192.168.1.64:5000）验证可正常访问，再调试客户端。

2. 匹配客户端运行环境的访问地址 #

• 如果你用安卓模拟器调试：需用安卓模拟器预留的宿主机映射IP 10.0.2.2 代替127.0.0.1/localhost，端口用服务实际监听的5000/5001
• 如果你用真机调试：确保手机和电脑在同一局域网下，地址填电脑的局域网IP加服务端口，比如192.168.1.64:5000
• 无需使用Conveyor生成的映射端口，Conveyor是专为IIS Express做外网/局域网映射的工具，直接修改服务监听规则即可

3. 配置移动端网络权限 #

以安卓平台为例：

• 在AndroidManifest.xml中添加基础网络权限：

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

• 如果用明文HTTP端口访问，安卓9及以上版本默认禁用明文请求，需在AndroidManifest.xml的application节点添加配置允许明文流量：

<application ... android:usesCleartextTraffic="true">

• 如果用HTTPS端口访问：自签名证书需要将公钥放到安卓项目的Assets目录，加载后生成SslCredentials传入Channel构造参数，不可用ChannelCredentials.Insecure直接连接HTTPS端口。

4. Channel配置注意事项 #

gRPC.Core的Channel构造参数确实不需要加http:///https://前缀，你之前的理解是正确的，加前缀会触发DNS解析错误。

修正后示例代码 #

public static async Task<Msg.SessionTokenResponse> test()
{
    // 安卓模拟器填10.0.2.2:5000，同局域网真机填192.168.1.64:5000
    var channel = new Channel("10.0.2.2:5000", ChannelCredentials.Insecure);

    var client = new AuthenticationService.AuthenticationServiceClient(channel);
    var request = new Msg.SessionTokenRequest();

    try
    {
        return await client.CreateSessionTokenAsync(request);
    }
    catch(Exception ex)
    {
        Console.WriteLine(ex.Message);
        // 不要用throw ex，会丢失原始堆栈信息
        throw;
    }
    finally
    {
        await channel.ShutdownAsync();
    }
}

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