UWP应用调用MessageWebSocket.ConnectAsync时遇服务器连接失败异常求助

我之前也碰到过UWP里用MessageWebSocket连接本地WebSocket服务器失败的情况，结合你的问题，给你整理几个实用的排查和解决方向：

1. 先确认服务器端是否正常工作 #

• 第一步别忙着查客户端，先验证你的WebSocket服务器确实在localhost:8097端口监听，并且/devtools这个路径是正确的。可以用浏览器控制台直接测试：在控制台输入new WebSocket('ws://localhost:8097/devtools')，看能不能成功建立连接；或者用Postman这类工具的WebSocket客户端来测试，先排除服务器本身的问题。
• 另外检查本地防火墙或杀毒软件，有没有拦截8097端口的通信——很多时候本地连接失败都是被安全软件挡了。

2. 配置UWP的网络权限 #

UWP应用有严格的网络隔离机制，必须手动配置权限才能访问网络：

• 打开你的Package.appxmanifest文件，切换到「功能」标签页，勾选专用网络(客户端)（因为localhost属于专用网络），如果之后需要访问公网，还要勾选Internet(客户端)。
• 也可以直接编辑XML代码，在<Capabilities>节点下添加：

<Capability Name="privateNetworkClientServer" />
<Capability Name="internetClient" />

3. 优化MessageWebSocket的连接逻辑 #

• 调用ConnectAsync之前，记得先设置Control.MessageType，比如服务器发送文本消息的话，就设为SocketMessageType.Utf8，不设置的话可能会导致连接异常。
• 给Closed事件加个处理函数，能拿到更具体的关闭原因，比模糊的异常信息有用多了：

var webSocket = new MessageWebSocket();
webSocket.Control.MessageType = SocketMessageType.Utf8;

// 监听关闭事件获取详细错误
webSocket.Closed += (sender, args) =>
{
    Debug.WriteLine($"连接关闭，错误码: {args.Code}, 原因: {args.Reason}");
};

try
{
    await webSocket.ConnectAsync(new Uri("ws://localhost:8097/devtools"));
}
catch (Exception ex)
{
    // 捕获COMException获取HRESULT，方便定位具体问题
    if (ex is COMException comEx)
    {
        Debug.WriteLine($"连接失败，HRESULT: {comEx.HResult:X}");
    }
}

• 如果你的服务器是同一台机器上的桌面应用，UWP默认禁止环回访问，需要开启环回豁免。用PowerShell执行下面的命令（替换成你的应用包名）：

CheckNetIsolation LoopbackExempt -a -n="你的应用包名"

应用包名可以在Package.appxmanifest的「打包」标签页找到，或者Visual Studio项目属性的「打包」选项里查看。

4. 捕获更精准的错误信息 #

你现在拿到的异常信息太模糊，试试捕获COMException——UWP的网络异常基本都是COM异常，里面的HRESULT能帮你定位具体问题，比如0x80072EFD通常是网络连接失败（服务器没启动/端口错误），0x80070005是权限不足。

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