.NET MAUI WebSocket在Android 5/8无法连接的解决方法咨询

针对你的WebSocket在Android 11正常、但Android 5/8设备提示“无法连接到远程服务器”的问题，结合System.Net.WebSockets的使用场景，给出以下针对性解决办法：

1. 强制启用TLS 1.2兼容 #

Android 5.0及部分8.0设备默认未开启TLS 1.2支持，而当前绝大多数WSS服务器要求使用TLS 1.2及以上版本加密。在连接前添加TLS版本配置：

// 在ConnectAsync调用前设置
ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12 | SecurityProtocolType.Tls11;

如果是Xamarin.Android项目，还可以在MainActivity的OnCreate方法中补充系统级配置：

Android.Net.Ssl.SslContext.Default?.SetProtocolEnabled(Android.Net.Ssl.SslProtocol.Tls12, true);

2. 处理SSL证书兼容性问题 #

旧Android版本对SSL证书的验证逻辑更严格，若服务器证书使用了旧签名算法（如SHA-1）或证书链不完整，会导致连接失败：

• 确认服务器证书使用SHA-256及以上的签名算法，且证书链完整（包含根证书和中间证书）。
• 测试环境下可临时绕过证书验证（生产环境禁止使用）：

ServicePointManager.ServerCertificateValidationCallback += (sender, cert, chain, sslPolicyErrors) => true;

3. 替换为兼容性更好的第三方WebSocket库 #

System.Net.WebSockets在旧Android系统上的兼容性有限，建议切换到专门的第三方库，比如WebSocketSharp：

using WebSocketSharp;

// 初始化WebSocket连接
var ws = new WebSocket("wss://url?token=" + Token);
// 强制使用TLS 1.2
ws.SslConfiguration.EnabledSslProtocols = System.Security.Authentication.SslProtocols.Tls12;

// 连接成功回调
ws.OnOpen += (sender, e) => {
    ws.Send(msg);
};

// 接收消息回调
ws.OnMessage += (sender, e) => {
    string receivedMessage = e.Data;
    JObject jsonObject = JObject.Parse(receivedMessage);
    Status = (string)jsonObject["data"]["state"][0][1];
};

// 启动连接
ws.Connect();

4. 确认网络权限与后台限制 #

• 确保AndroidManifest.xml中已添加网络权限：

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

• Android 8.0及以上设备对后台网络有管控，若应用在后台运行，需添加ACCESS_NETWORK_STATE权限，并处理网络状态变化，避免连接被系统中断。

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