2c59500e27
安全修复: - WebSocket Token 增加 Redis 有效性校验（已登出用户无法建立 WS） 功能修复: - GetRecommendFriends 改为批量查询，正确返回用户名/昵称/头像 - 上下线通知：OnlineService 通过接口注入获取好友列表推送状态变更 - 管理端在线用户 API 补充用户名信息 代码质量: - 所有 json.Marshal/Redis 错误增加检查与日志 - ContactController 13 个 endpoint 统一走 handleError 业务错误映射 - 管理端 Controller 补全包注释、函数注释和结构化日志 - 前端 5 个联系人页面 avatar 工具函数抽取到 utils/avatar.js Made-with: Cursor
146 lines
3.5 KiB
Go
146 lines
3.5 KiB
Go
package ws
|
||
|
||
import (
|
||
"sync"
|
||
|
||
"github.com/echochat/backend/pkg/logs"
|
||
"go.uber.org/zap"
|
||
)
|
||
|
||
// Hub 管理所有活跃的 WebSocket 客户端连接
|
||
// 提供按 userID 注册/注销/查找连接的能力，支持优雅关闭
|
||
type Hub struct {
|
||
clients map[int64]*Client // userID -> Client 映射
|
||
register chan *Client // 注册通道
|
||
unregister chan *Client // 注销通道
|
||
mu sync.RWMutex // 保护 clients map 的读写锁
|
||
stopCh chan struct{} // 停止信号，用于优雅关闭 Run 循环
|
||
}
|
||
|
||
// NewHub 创建 Hub 实例
|
||
func NewHub() *Hub {
|
||
return &Hub{
|
||
clients: make(map[int64]*Client),
|
||
register: make(chan *Client, 256),
|
||
unregister: make(chan *Client, 256),
|
||
stopCh: make(chan struct{}),
|
||
}
|
||
}
|
||
|
||
// Run 启动 Hub 主循环，处理连接注册和注销
|
||
// 应在单独的 goroutine 中运行，通过 Stop() 方法优雅关闭
|
||
func (h *Hub) Run() {
|
||
for {
|
||
select {
|
||
case <-h.stopCh:
|
||
h.mu.Lock()
|
||
for uid, client := range h.clients {
|
||
client.SetClosedByHub()
|
||
close(client.send)
|
||
delete(h.clients, uid)
|
||
}
|
||
h.mu.Unlock()
|
||
logs.Info(nil, "ws.hub.Run", "Hub 已停止，所有连接已关闭")
|
||
return
|
||
|
||
case client := <-h.register:
|
||
h.mu.Lock()
|
||
if old, ok := h.clients[client.UserID]; ok {
|
||
logs.Info(nil, "ws.hub.Run", "用户重复连接，关闭旧连接",
|
||
zap.Int64("user_id", client.UserID))
|
||
old.SetClosedByHub()
|
||
close(old.send)
|
||
}
|
||
h.clients[client.UserID] = client
|
||
h.mu.Unlock()
|
||
|
||
logs.Info(nil, "ws.hub.Run", "客户端已注册",
|
||
zap.Int64("user_id", client.UserID),
|
||
zap.Int("online_count", h.OnlineCount()))
|
||
|
||
case client := <-h.unregister:
|
||
h.mu.Lock()
|
||
if existing, ok := h.clients[client.UserID]; ok && existing == client {
|
||
delete(h.clients, client.UserID)
|
||
close(client.send)
|
||
}
|
||
h.mu.Unlock()
|
||
|
||
logs.Info(nil, "ws.hub.Run", "客户端已注销",
|
||
zap.Int64("user_id", client.UserID),
|
||
zap.Int("online_count", h.OnlineCount()))
|
||
}
|
||
}
|
||
}
|
||
|
||
// Stop 优雅关闭 Hub，停止 Run 循环并断开所有客户端连接
|
||
func (h *Hub) Stop() {
|
||
close(h.stopCh)
|
||
}
|
||
|
||
// Register 注册客户端连接
|
||
func (h *Hub) Register(client *Client) {
|
||
h.register <- client
|
||
}
|
||
|
||
// Unregister 注销客户端连接
|
||
func (h *Hub) Unregister(client *Client) {
|
||
h.unregister <- client
|
||
}
|
||
|
||
// GetClient 根据 userID 获取客户端连接（线程安全）
|
||
func (h *Hub) GetClient(userID int64) (*Client, bool) {
|
||
h.mu.RLock()
|
||
defer h.mu.RUnlock()
|
||
client, ok := h.clients[userID]
|
||
return client, ok
|
||
}
|
||
|
||
// SendToUser 向指定用户发送消息（仅本地 Hub）
|
||
// 如果用户不在本实例或缓冲区满，返回 false
|
||
func (h *Hub) SendToUser(userID int64, data []byte) bool {
|
||
h.mu.RLock()
|
||
client, ok := h.clients[userID]
|
||
h.mu.RUnlock()
|
||
|
||
if !ok {
|
||
return false
|
||
}
|
||
|
||
select {
|
||
case client.send <- data:
|
||
return true
|
||
default:
|
||
logs.Warn(nil, "ws.hub.SendToUser", "发送缓冲区已满，消息被丢弃",
|
||
zap.Int64("user_id", userID),
|
||
zap.Int("data_len", len(data)))
|
||
return false
|
||
}
|
||
}
|
||
|
||
// OnlineCount 返回当前在线连接数
|
||
func (h *Hub) OnlineCount() int {
|
||
h.mu.RLock()
|
||
defer h.mu.RUnlock()
|
||
return len(h.clients)
|
||
}
|
||
|
||
// OnlineUserIDs 返回所有在线用户 ID 列表
|
||
func (h *Hub) OnlineUserIDs() []int64 {
|
||
h.mu.RLock()
|
||
defer h.mu.RUnlock()
|
||
ids := make([]int64, 0, len(h.clients))
|
||
for id := range h.clients {
|
||
ids = append(ids, id)
|
||
}
|
||
return ids
|
||
}
|
||
|
||
// IsOnline 检查指定用户是否在线（本地 Hub）
|
||
func (h *Hub) IsOnline(userID int64) bool {
|
||
h.mu.RLock()
|
||
defer h.mu.RUnlock()
|
||
_, ok := h.clients[userID]
|
||
return ok
|
||
}
|