MAUI 本身不内置 SignalR 客户端支持，但可以通过 Microsoft.AspNetCore.SignalR.Client NuGet 包在 .NET MAUI 应用中接入 SignalR 服务，实现跨平台（Android/iOS/Windows/macOS）的实时通信。关键在于：用 .NET 客户端 SDK 替代 JS 客户端，适配 MAUI 的生命周期和线程模型。
安装 SignalR .NET 客户端包
在 MAUI 项目（.csproj）中添加官方客户端库：
打开终端，执行：dotnet add package Microsoft.AspNetCore.SignalR.Client确保目标框架为
net8.0或更高（MAUI 8+ 推荐），SignalR.Client 8.x 与之完全兼容 无需额外引入 JavaScript 或 signalr.js —— 这是 MAUI 与 Web 前端的根本区别
配置 Hub 连接与生命周期管理
SignalR 连接需配合 MAUI 页面或 ViewModel 的生命周期启动/停止，避免内存泄漏或后台无效连接：
在 ViewModel 中声明HubConnection实例，并在构造时初始化 使用
OnConnectedAsync和
OnClosedAsync处理连接状态变化（如重连逻辑） 在页面
OnAppearing中调用
connection.StartAsync()，
OnDisappearing中调用
StopAsync()注意：MAUI 主线程非 UI 线程安全，所有
SendAsync和事件回调建议用
MainThread.InvokeOnMainThreadAsync更新界面
定义强类型 Hub 和消息处理
推荐使用强类型 Hub 客户端提升可维护性（比字符串方法名更安全）：
先在服务端定义接口，例如：IChatClient，含
ReceiveMessage(string user, string msg)MAUI 客户端创建继承自
HubConnectionBuilder的连接，并指定该接口：
.WithUrl("https://api.example.com/chathub")
通过 connection.On<string string>("ReceiveMessage", (user, msg) => { /* 更新 UI */ })</string> 订阅服务器推送
发送消息用：await connection.InvokeAsync("SendMessage", userName, text)
处理平台差异与常见问题
MAUI 各平台对 WebSocket 支持略有差异，需针对性适配：
Android/iOS：默认启用 WebSocket，但需在AndroidManifest.xml或
Info.plist中允许 HTTPS 和后台网络（尤其 iOS 要配置
NSAppTransportSecurity） Windows：无特殊限制，但调试时注意防火墙是否放行 SignalR 端口（如 5001/5002） 连接失败？ 检查服务端是否启用 CORS 并允许 MAUI 应用的 Origin（如
https://localhost:12345或空域） 消息收不到？ 确认服务端
Clients.All.SendAsync方法名与客户端
On("xxx") 完全一致（大小写敏感）
基本上就这些。MAUI + SignalR 不是开箱即用，但也不复杂——核心就是用对 .NET 客户端包、管好连接生命周期、绕过 UI 线程限制。适合做内部协同工具、设备状态监控、工单实时提醒等场景。
