fix(phase2a): 代码审查修复 - 8项关键/重要问题

安全修复:
- WebSocket Token 增加 Redis 有效性校验（已登出用户无法建立 WS）

功能修复:
- GetRecommendFriends 改为批量查询，正确返回用户名/昵称/头像
- 上下线通知：OnlineService 通过接口注入获取好友列表推送状态变更
- 管理端在线用户 API 补充用户名信息

代码质量:
- 所有 json.Marshal/Redis 错误增加检查与日志
- ContactController 13 个 endpoint 统一走 handleError 业务错误映射
- 管理端 Controller 补全包注释、函数注释和结构化日志
- 前端 5 个联系人页面 avatar 工具函数抽取到 utils/avatar.js

Made-with: Cursor

backend/go-service/pkg/ws/client.go

@@ -2,6 +2,7 @@ package ws
 
 import (
 	"encoding/json"
+	"sync/atomic"
 	"time"
 
 	"github.com/echochat/backend/pkg/logs"
@@ -28,6 +29,7 @@ type Client struct {
 	send         chan []byte       // 待发送消息缓冲队列
 	UserID       int64             // 关联的用户 ID
 	onDisconnect DisconnectHandler // 断线回调（清理在线状态等）
+	closedByHub  int32             // 原子标记：是否被 Hub 主动踢出（用于避免重复连接时的竞态清理）
 }
 
 // NewClient 创建客户端实例
@@ -45,6 +47,18 @@ func (c *Client) SetOnDisconnect(handler DisconnectHandler) {
 	c.onDisconnect = handler
 }
 
+// SetClosedByHub 标记此连接被 Hub 主动关闭（重复连接踢出场景）
+// 线程安全，使用 atomic 操作
+func (c *Client) SetClosedByHub() {
+	atomic.StoreInt32(&c.closedByHub, 1)
+}
+
+// IsClosedByHub 检查此连接是否被 Hub 主动关闭
+// 断线回调中使用此方法判断是否需要执行下线清理
+func (c *Client) IsClosedByHub() bool {
+	return atomic.LoadInt32(&c.closedByHub) == 1
+}
+
 // MessageHandler 消息处理回调函数类型
 type MessageHandler func(client *Client, msg *Message)