.NET下gRPC使用Unix域套接字遇连接被主动拒绝问题排查

核心问题分析 #

你遇到的连接拒绝错误，虽提示localhost:80，但实际是以下关键问题导致：

• 客户端的Task.Delay(5000)未生效，服务器未完成启动就发起连接
• Unix Domain Socket 文件权限不兼容（Windows服务用户与GUI用户权限隔离）
• gRPC Channel 地址配置触发默认端口连接逻辑
• 缺少连接重试机制，服务器启动耗时不稳定

具体修复步骤 #

1. 修复客户端启动延迟逻辑 #

构造函数中直接调用Task.Delay(5000)不会阻塞主线程（未加await），延迟完全无效。将初始化逻辑移到窗口Loaded事件中，使用异步等待：

public partial class MainWindow : Window
{
    private GrpcChannel _channel;
    private GrpcSettings.GrpcSettingsClient _grpcSettingsClient;
    
    public MainWindow()
    {
        InitializeComponent();
        Loaded += MainWindow_Loaded;
    }

    private async void MainWindow_Loaded(object sender, RoutedEventArgs e)
    {
        // 等待服务器启动，可根据实际情况调整时长
        await Task.Delay(5000);

        var socketPath = Path.Combine(@"C:\Temp", "app-socket.socket");

        _channel = GrpcChannel.ForAddress("http://unix", new GrpcChannelOptions
        {
            HttpHandler = CreateHttpHandler(socketPath)
        });
        _grpcSettingsClient = new GrpcSettings.GrpcSettingsClient(_channel);

        DataContext = new MainViewModel(_grpcSettingsClient);
    }

    private static HttpMessageHandler CreateHttpHandler(string socketPath)
    {
        var udsEndPoint = new UnixDomainSocketEndPoint(socketPath);
        return new SocketsHttpHandler
        {
            ConnectCallback = async (context, cancellationToken) =>
            {
                var socket = new Socket(AddressFamily.Unix, SocketType.Stream, ProtocolType.Unspecified);
                await socket.ConnectAsync(udsEndPoint, cancellationToken);
                return new NetworkStream(socket, ownsSocket: true);
            }
        };
    }
}

2. 修正gRPC Channel地址配置 #

将GrpcChannel.ForAddress的地址改为http://unix（或其他非真实域名），避免gRPC框架默认尝试连接localhost:80端口，确保完全使用自定义的Unix Socket handler。

3. 配置Unix Domain Socket文件权限 #

Windows服务运行的用户（通常是Local System或专用服务账户）与GUI本地用户存在权限隔离，需确保Socket文件所在目录和文件本身允许GUI用户读写：

服务器端修改：创建Socket后设置权限

在Kestrel配置后，添加权限设置代码（需引用System.Security.AccessControl）：

builder.WebHost.ConfigureKestrel(serverOptions =>
{
    if (File.Exists(socketPath))
    {
        File.Delete(socketPath);
    }

    serverOptions.ListenUnixSocket(socketPath, listenOptions =>
    {
        listenOptions.Protocols = Microsoft.AspNetCore.Server.Kestrel.Core.HttpProtocols.Http2;
    });
});

// 服务器启动后设置Socket文件权限
var app = builder.Build();

// 获取Socket文件的访问控制列表
var fileInfo = new FileInfo(socketPath);
var security = fileInfo.GetAccessControl();
// 添加本地用户组的读写权限（根据实际环境调整用户/组）
security.AddAccessRule(new FileSystemAccessRule(
    new SecurityIdentifier(WellKnownSidType.BuiltinUsersSid, null),
    FileSystemRights.Read | FileSystemRights.Write,
    AccessControlType.Allow));
fileInfo.SetAccessControl(security);

4. 添加客户端连接重试机制 #

服务器启动耗时可能波动，固定延迟无法适配所有情况，使用重试逻辑确保连接成功（可借助Polly库）：

安装Polly包

Install-Package Polly

修改客户端连接逻辑

private async void MainWindow_Loaded(object sender, RoutedEventArgs e)
{
    var socketPath = Path.Combine(@"C:\Temp", "app-socket.socket");
    var retryPolicy = Policy
        .Handle<HttpRequestException>()
        .Or<SocketException>()
        .WaitAndRetryAsync(5, retryAttempt => TimeSpan.FromSeconds(Math.Pow(2, retryAttempt)));

    await retryPolicy.ExecuteAsync(async () =>
    {
        _channel = GrpcChannel.ForAddress("http://unix", new GrpcChannelOptions
        {
            HttpHandler = CreateHttpHandler(socketPath)
        });
        // 发起一个测试调用验证连接
        await _grpcSettingsClient.GetSettingsAsync(new EmptyRequest());
    });

    _grpcSettingsClient = new GrpcSettings.GrpcSettingsClient(_channel);
    DataContext = new MainViewModel(_grpcSettingsClient);
}

5. 服务器端启动验证 #

Windows服务中Console.WriteLine无法输出，添加日志记录确保服务器已成功监听Socket：

// 注入日志
var logger = app.Services.GetRequiredService<ILogger<Program>>();
logger.LogInformation($"gRPCServer is running and listening on {socketPath}");

额外注意事项 #

• 确保C:\Temp目录存在，服务器启动前检查并创建目录：Directory.CreateDirectory(@"C:\Temp");
• 调试Windows服务时，可先以控制台模式运行（注释builder.Host.UseWindowsService();），验证Socket连接正常后再切换为服务模式
• 避免多个服务器实例同时运行，确保Socket文件被正确删除后再启动

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