Android端SignalR Core Hub实现：连接成功但消息处理未触发

以下是针对你问题的具体排查步骤和修复建议：

1. 验证Hub方法名称的大小写匹配 #

SignalR Kotlin客户端默认严格区分大小写，请确认服务器端调用的方法名称与客户端监听的完全一致。比如服务器若调用的是setUserStatus（首字母小写），客户端监听SetUserStatus就无法匹配。而iOS客户端可能因底层匹配逻辑不区分大小写，导致可以正常接收。

2. 检查序列化兼容性 #

字段匹配与类型一致性 #

• 确认服务器返回的JSON字段名与UserStatus类的@SerializedName完全一致，比如服务器是否返回userId而非user_id或其他变体。
• 检查字段类型是否匹配：比如服务器返回的userId是字符串类型，而客户端定义为Int，会导致序列化失败，消息被静默丢弃。

显式配置Jackson序列化（若需要） #

SignalR客户端默认使用Jackson处理序列化，确保项目中Jackson依赖正常，且无自定义序列化逻辑干扰。可尝试添加显式配置：

val mapper = ObjectMapper()
mapper.registerModule(KotlinModule())
val hubConnection = HubConnectionBuilder.create(serverUrl)
    .setJsonHubProtocol(JacksonHubProtocol(mapper))
    .build()

3. 确认连接生命周期与稳定性 #

• 添加连接关闭监听，排查是否连接意外断开：

hubConnection.onClosed { error ->
    Log.e(TAG, "连接已关闭：${error?.message ?: "无错误信息"}")
}

• 检查SignalRService实例是否被意外回收：将signalRService设为Application的全局变量，确保其生命周期与应用一致，避免因GC回收导致连接或监听器失效。

4. 版本与协议兼容性检查 #

你使用的客户端版本是com.microsoft.signalr:signalr:7.0.0（ASP.NET Core SignalR客户端），但参考的是ASP.NET SignalR 2.2的文档。这两类SignalR是完全独立的实现，协议不兼容：

• 若服务器是ASP.NET Core SignalR：确认服务器端版本与客户端版本（7.0.x）尽量一致，且URL格式正确（应指向具体Hub端点，比如wss://xxxx.yyyy.com/userHub，而非/signalr）。
• 若服务器是旧版ASP.NET SignalR：需改用旧版Java客户端（Microsoft.AspNet.SignalR.Client），而非当前的ASP.NET Core客户端。

5. 开启详细日志排查 #

开启SignalR客户端的DEBUG日志，查看是否有消息接收记录或序列化错误：

val hubConnection = HubConnectionBuilder.create(serverUrl)
    .setLogger(object : Logger {
        override fun log(level: Logger.Level, message: String) {
            Log.d(TAG, "[SignalR ${level.name}] $message")
        }
    })
    .build()

通过日志可确认客户端是否接收到SetUserStatus消息，以及是否在解析时出现异常。

6. 验证服务器端调用逻辑 #

确认服务器端是向所有客户端（或目标Android客户端）发送消息，比如：

// ASP.NET Core SignalR 示例
await Clients.All.SendAsync("SetUserStatus", userStatus);

避免服务器仅向iOS客户端的连接ID发送消息，导致Android端无法接收。

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