fix(meeting): Task 16 修复 code-reviewer 审计 P2 七项 + Nit 七项

覆盖 Phase 2e-2 代码审查报告（docs/reviews/2026-04-23-phase2e-2-code-review.md）
P2/Nit 收尾批次，均在本仓库完成闭环；剩余 5 项登记推迟至 Phase 2f/3。

===== P2 七项 =====
- P2-1 cleanupUserResources 补 transport 清理
  · media-server 新增 DELETE /internal/v1/transports/:id + transport.service.closeTransport
  · Go MediaOrchestrator 接口新增 CloseTransport；HTTP 实现按 doCloseRequest 走 4xx 幂等 + 指数退避
  · meeting_signal_service.cleanupUserResources 新增 "transport:<id>" 分支
- P2-2 preview.vue 快速切设备竞态
  · previewSeq 序号 + nextTick 后 stale 判断，丢弃过期结果
  · onVideoChange/onAudioChange 走 scheduleRestartPreview 200ms 防抖
  · onBeforeUnmount 清理 changeDebounceTimer
- P2-3 room.vue onLoad redirectTo 后补 return
  · 引入 redirectingToJoin 守卫，跳转页不再执行 onMounted 初始化
- P2-6 generateUniqueRoomCode 重试上限监控
  · 重试后成功：Warn 日志（码空间健康度告警）
  · 重试耗尽：Error 日志 + ErrRoomCodeConflict
  · 修正 logs.Error 调用签名（去掉多余的 nil）
- P2-7 SendChatMessage 服务端长度 + 频率限制
  · 新增 ErrChatContentEmpty / ErrChatContentTooLong / ErrChatRateLimited
  · utf8.RuneCountInString 校验 500 字符上限
  · Redis INCR + EXPIRE 滑动窗口（30 条/60s，首次写入 EXPIRE 兜底）
  · controller.handleError 映射为 HTTP 400
- P2-8 MEETING_ENDED_REASON_LABEL 覆盖复核
  · 新增前端专属常量 MEETING_ENDED_REASON_KICKED + 文案
  · store/meeting.js _onMemberKicked 使用常量
  · 同步修复后端 OnWSDisconnect 硬编码 "ws_disconnect" → constants.MeetingLeftReasonDisconnect
- P2 已修 P2-1/2/3/6/7/8；P2-4（WS token 迁出 URL query）与 P2-5（Chat 服务拆分）登记推迟

===== Nit 七项 =====
- Nit: kind:id 解析改用 strings.SplitN
  · cleanupUserResources / pushExistingRoomState 两处同步
- Nit: resourceTTL 中央化
  · 新增 constants.MeetingResourceTrackTTLSeconds（3600）
  · meeting_signal_service.go resourceTTL 由 const 改 var 并引用常量
- Nit: ws/handler.go CheckOrigin 白名单
  · NewHandler 新增 serverCfg 依赖；checkOrigin 支持同源放行 / dev 模式放行 / release 模式白名单严格匹配
  · config.ServerConfig 新增 WSAllowedOrigins（逗号分隔）+ AllowedOrigins() / IsRelease() 辅助方法
  · provider.go 新增 provideServerConfig，wire_gen.go 同步
- Nit: http_media_orchestrator.go 超时 + CreateRouter 重试
  · 默认 TimeoutMS 5000→10000ms 兼容 Worker 冷启动
  · 新增 CreateRouterRetry（默认 1 次，300ms 退避），仅对非 404 错误重试
  · config.dev.yaml / config.docker.yaml 同步写入显式配置
- Nit: deploy-public.sh REDIS_PASSWORD × redis.conf 联动校验
  · 检测 REDIS_PASSWORD 与 redis.conf 的 requirepass 配对一致性
  · redis.conf 增加公网部署 requirepass 使用说明
- Nit: media-server internal-auth isPrivatePath 按 path 匹配
  · 剔除 query/hash 后再与白名单 startsWith，避免 "?" 语义混淆
- Nit: mediasoup-client.js in-flight 锁走读确认
  · finally 分支已覆盖 resolve/reject 两路，追加注释强化语义
- Nit 走读复核：_onMemberLeft 整槽关闭 vs _onProducerNew(closed=true) 精确匹配 producerId
  · 粒度正确，无需改动（登记结论）

===== 构建验证 =====
- go vet ./... / go build ./... 通过
- frontend npm run build:h5 通过（仅 uni-app legacy warning，无 error）
- media-server npx tsc --noEmit 通过

===== 审查追踪小节 =====
docs/reviews/2026-04-23-phase2e-2-code-review.md 追加 "Task 16 修复追踪（2026-04-24 更新）"：
- 已修复一览（本批次 14 处 + 历次 commit cdaa39d / ea2bf96 / f5ae095 / 5ed14c2）
- 推迟登记表（P2-4 / P2-5 / 端口收敛 / appData 校验 / RFC3339 时间格式，共 5 项）

Made-with: Cursor

backend/go-service/app/constants/meeting.go

@@ -90,6 +90,16 @@ const (
 	MeetingEmptyRoomTTLSeconds = 300 // 空房销毁 TTL（5 分钟）
 	MeetingInviteTokenTTL      = 600 // 邀请链接 Token TTL（10 分钟）
 	MeetingChatRetentionHours  = 24  // 会议聊天保留时长（会议结束后）
+
+	// Task 16 P2-7：服务端聊天限流（防止客户端校验被绕过）
+	MeetingChatMaxContentLen    = 500 // 单条消息最大字符数（Unicode rune 计数）
+	MeetingChatRateLimitPerMin  = 30  // 单用户单会议每分钟最大条数
+	MeetingChatRateLimitWindowS = 60  // 限流滑动窗口秒数（配合 Redis INCR + EXPIRE）
+
+	// Task 16 Nit：单个用户资源追踪集合 TTL（秒）
+	// 原硬编码在 meeting_signal_service.go::resourceTTL = time.Hour；
+	// 中央化到 constants 便于统一修改 + 单元测试覆盖
+	MeetingResourceTrackTTLSeconds = 3600 // 1 小时
 )
 
 // 会议 WS 事件常量（设计文档 §6.3）

backend/go-service/app/meeting/controller/meeting_controller.go

@@ -64,7 +64,13 @@ func (ctl *MeetingController) handleError(c *gin.Context, err error, fallbackMsg
 		errors.Is(err, service.ErrRoomCodeConflict),
 		errors.Is(err, service.ErrKickSelfForbidden),
 		errors.Is(err, service.ErrTransferToSelf),
-		errors.Is(err, service.ErrTransferTargetInvalid):
+		errors.Is(err, service.ErrTransferTargetInvalid),
+		// P2-7 会议聊天服务端校验失败：内容为空 / 超长 / 触发限流
+		// 当前使用 400（由 ResponseBadRequest 返回），保持与其余业务错误一致；
+		// 未来若需要精细区分（如 ErrChatRateLimited → 429、ErrChatContentTooLong → 413），可拆分分支
+		errors.Is(err, service.ErrChatContentEmpty),
+		errors.Is(err, service.ErrChatContentTooLong),
+		errors.Is(err, service.ErrChatRateLimited):
 		utils.ResponseBadRequest(c, err.Error())
 	default:
 		logs.Warn(c.Request.Context(), "controller.meeting_controller.handleError",

backend/go-service/app/meeting/service/http_media_orchestrator.go

@@ -65,7 +65,10 @@ type HTTPMediaOrchestrator struct {
 func NewHTTPMediaOrchestrator(cfg *config.Config) *HTTPMediaOrchestrator {
 	mc := cfg.MediaServer
 	if mc.TimeoutMS <= 0 {
-		mc.TimeoutMS = 5000
+		// Task 16 Nit（代码审查 2026-04-23 第 15 条）：
+		// 原默认 5000ms 对 CreateRouter 偏紧（Worker 冷启动 + Router 首次创建在慢机上可达 6~8s），
+		// 统一将默认超时放宽到 10000ms，显式配置（config.*.yaml）不受影响
+		mc.TimeoutMS = 10000
 	}
 	if mc.CloseTimeoutMS <= 0 {
 		mc.CloseTimeoutMS = 2000
@@ -73,6 +76,14 @@ func NewHTTPMediaOrchestrator(cfg *config.Config) *HTTPMediaOrchestrator {
 	if mc.CloseRetry < 0 {
 		mc.CloseRetry = 0
 	}
+	if mc.CreateRouterRetry < 0 {
+		mc.CreateRouterRetry = 0
+	}
+	if mc.CreateRouterRetry == 0 {
+		// Task 16 Nit（代码审查 2026-04-23 第 15 条）：
+		// 默认允许 1 次轻量重试，300ms 退避，仅对非 404 错误生效
+		mc.CreateRouterRetry = 1
+	}
 	// 去除 base_url 末尾斜杠，统一拼接风格
 	mc.BaseURL = strings.TrimRight(mc.BaseURL, "/")
 
@@ -113,15 +124,42 @@ func (h *HTTPMediaOrchestrator) CreateRouter(ctx context.Context, roomCode strin
 		RouterID        string          `json:"routerId"`
 		RtpCapabilities json.RawMessage `json:"rtpCapabilities"`
 	}
-	if err := h.doRequest(ctx, requestOptions{
-		method:    http.MethodPost,
-		path:      "/internal/v1/routers",
-		body:      reqBody,
-		timeoutMS: h.cfg.TimeoutMS,
-		funcName:  funcName,
-		logFields: []zap.Field{zap.String("room_code", roomCode)},
-	}, &resp); err != nil {
-		return "", err
+
+	// Task 16 Nit：CreateRouter 在 5xx / 网络错误时允许 CreateRouterRetry 次重试（退避 300ms）
+	// - 404 不应出现在 POST /routers，若出现视为 media-server 配置异常，不重试
+	// - ctx.Err() 立即终止（上游取消或超时）
+	attempts := h.cfg.CreateRouterRetry + 1
+	var lastErr error
+	for i := 0; i < attempts; i++ {
+		if i > 0 {
+			select {
+			case <-ctx.Done():
+				return "", ctx.Err()
+			case <-time.After(300 * time.Millisecond):
+			}
+			logs.Info(ctx, funcName, "CreateRouter 重试",
+				zap.String("room_code", roomCode),
+				zap.Int("attempt", i+1))
+		}
+		err := h.doRequest(ctx, requestOptions{
+			method:    http.MethodPost,
+			path:      "/internal/v1/routers",
+			body:      reqBody,
+			timeoutMS: h.cfg.TimeoutMS,
+			funcName:  funcName,
+			logFields: []zap.Field{zap.String("room_code", roomCode), zap.Int("attempt", i+1)},
+		}, &resp)
+		if err == nil {
+			lastErr = nil
+			break
+		}
+		lastErr = err
+		if errors.Is(err, ErrMediaResourceNotFound) {
+			break
+		}
+	}
+	if lastErr != nil {
+		return "", lastErr
 	}
 
 	info := &routerInfoCache{
@@ -257,6 +295,21 @@ func (h *HTTPMediaOrchestrator) ConnectTransport(ctx context.Context, transportI
 	}, nil)
 }
 
+// CloseTransport 调用 DELETE /internal/v1/transports/:id（Task 16 P2-1 引入）
+// 404 映射为 ErrMediaResourceNotFound（上层 cleanupUserResources 视为已清理）
+// 与 CloseProducer / CloseConsumer 保持同一重试/超时策略
+func (h *HTTPMediaOrchestrator) CloseTransport(ctx context.Context, transportID string) error {
+	funcName := "service.http_media_orchestrator.CloseTransport"
+
+	err := h.doCloseRequest(ctx, fmt.Sprintf("/internal/v1/transports/%s", transportID), funcName, []zap.Field{
+		zap.String("transport_id", transportID),
+	})
+	if errors.Is(err, ErrMediaResourceNotFound) {
+		return nil
+	}
+	return err
+}
+
 // CreateProducer 调用 POST /internal/v1/producers
 func (h *HTTPMediaOrchestrator) CreateProducer(ctx context.Context, req *CreateProducerReq) (string, error) {
 	funcName := "service.http_media_orchestrator.CreateProducer"

backend/go-service/app/meeting/service/interfaces.go

@@ -103,6 +103,10 @@ type MediaOrchestrator interface {
 	CreateTransport(ctx context.Context, req *CreateTransportReq) (*TransportInfo, error)
 	// ConnectTransport Transport DTLS 握手（幂等：重复 connect 对已连接 transport 视为成功）
 	ConnectTransport(ctx context.Context, transportID string, dtlsParameters json.RawMessage) error
+	// CloseTransport 主动关闭指定 Transport（Task 16 P2-1 引入）
+	// 场景：用户离会 / WS 断连时 cleanupUserResources 精确清理，避免等待 Router 级联
+	// 语义：404（Transport 已关闭/不存在）返回 ErrMediaResourceNotFound，上层可视为"已清理"幂等成功
+	CloseTransport(ctx context.Context, transportID string) error
 
 	// CreateProducer 在指定 send Transport 上创建 Producer
 	CreateProducer(ctx context.Context, req *CreateProducerReq) (producerID string, err error)
@@ -166,6 +170,11 @@ func (n *NoopMediaOrchestrator) ConnectTransport(_ context.Context, _ string, _
 	return nil
 }
 
+// CloseTransport 占位：直接返回 nil（Task 16 P2-1 引入）
+func (n *NoopMediaOrchestrator) CloseTransport(_ context.Context, _ string) error {
+	return nil
+}
+
 // CreateProducer 占位：返回伪造 ID
 func (n *NoopMediaOrchestrator) CreateProducer(_ context.Context, req *CreateProducerReq) (string, error) {
 	return "noop-producer-" + req.Kind, nil

backend/go-service/app/meeting/service/meeting_service.go

@@ -7,7 +7,9 @@ import (
 	"errors"
 	"fmt"
 	"strconv"
+	"strings"
 	"time"
+	"unicode/utf8"
 
 	"github.com/echochat/backend/app/constants"
 	"github.com/echochat/backend/app/dto"
@@ -45,6 +47,10 @@ var (
 	// ErrMediaServiceUnavailable 媒体服务当前不可用（Router 创建失败 / Node 宕机等）
 	// 用于 CreateRoom / JoinRoom 的补偿路径，将前台错误与"用户输入错误"区分开
 	ErrMediaServiceUnavailable = errors.New("媒体服务暂时不可用，请稍后重试")
+	// Task 16 P2-7：会议聊天服务端限流
+	ErrChatContentEmpty   = errors.New("消息内容不能为空")
+	ErrChatContentTooLong = errors.New("消息长度超过上限")
+	ErrChatRateLimited    = errors.New("发送过于频繁，请稍后再试")
 )
 
 // Redis key 前缀（设计文档 §5.4 - Redis 数据结构）
@@ -52,6 +58,8 @@ const (
 	redisKeyInvitePrefix       = "echo:meeting:invite:"       // 邀请 Token
 	redisKeyPasswordLockPrefix = "echo:meeting:lock:"         // 密码错误锁（code:user_id）
 	redisPasswordAttemptPrefix = "echo:meeting:pwd_attempt:"  // 密码错误计数
+	// Task 16 P2-7：会议聊天限流计数键，格式 "echo:meeting:chat_rate:<room>:<user_id>"
+	redisKeyChatRatePrefix = "echo:meeting:chat_rate:"
 )
 
 // MeetingService 会议业务服务
@@ -132,7 +140,12 @@ func (s *MeetingService) assertIsHost(ctx context.Context, room *model.MeetingRo
 }
 
 // generateUniqueRoomCode 生成唯一的 XXX-XXX-XXX 会议号，冲突最多重试 MeetingRoomCodeRetryMax 次
+// P2-6（代码审查 2026-04-23）：
+//   - 重试上限由 constants.MeetingRoomCodeRetryMax 控制（当前=3），避免死循环
+//   - 只要命中第 2 次及以后就打 Warn（正常情况下几乎不会碰撞，连续碰撞通常是码空间
+//     / 生成器被外部污染的信号，需要及早告警）
 func (s *MeetingService) generateUniqueRoomCode(ctx context.Context) (string, error) {
+	funcName := "service.meeting_service.generateUniqueRoomCode"
 	for i := 0; i < constants.MeetingRoomCodeRetryMax; i++ {
 		code, err := utils.GenerateMeetingRoomCode()
 		if err != nil {
@@ -143,9 +156,16 @@ func (s *MeetingService) generateUniqueRoomCode(ctx context.Context) (string, er
 			return "", err
 		}
 		if !exists {
+			if i > 0 {
+				logs.Warn(ctx, funcName, "会议号生成多次冲突后成功，请关注码空间健康度",
+					zap.Int("retry_count", i),
+					zap.String("code", code))
+			}
 			return code, nil
 		}
 	}
+	logs.Error(ctx, funcName, "会议号生成连续冲突达到上限，疑似码空间异常或并发洪水",
+		zap.Int("retry_max", constants.MeetingRoomCodeRetryMax))
 	return "", ErrRoomCodeConflict
 }
 
@@ -868,9 +888,24 @@ func (s *MeetingService) RedeemInviteToken(ctx context.Context, userID int64, to
 // ====== 会议内聊天 ======
 
 // SendChatMessage 会议内发送文本消息
+// Task 16 P2-7：加入服务端校验 + Redis 滑窗限流
+//   - 内容去除首尾空白后必须非空
+//   - Unicode rune 计数不得超过 MeetingChatMaxContentLen
+//   - 单用户单会议 MeetingChatRateLimitWindowS 秒内最多 MeetingChatRateLimitPerMin 条
 func (s *MeetingService) SendChatMessage(ctx context.Context, userID int64, code, content string) (*model.MeetingChat, error) {
 	funcName := "service.meeting_service.SendChatMessage"
 
+	trimmed := strings.TrimSpace(content)
+	if trimmed == "" {
+		return nil, ErrChatContentEmpty
+	}
+	if runeCount := utf8.RuneCountInString(trimmed); runeCount > constants.MeetingChatMaxContentLen {
+		logs.Debug(ctx, funcName, "聊天消息超长，拒绝",
+			zap.String("room_code", code), zap.Int64("user_id", userID),
+			zap.Int("rune_count", runeCount), zap.Int("limit", constants.MeetingChatMaxContentLen))
+		return nil, ErrChatContentTooLong
+	}
+
 	room, err := s.roomDAO.GetByCode(ctx, code)
 	if err != nil {
 		return nil, err
@@ -885,10 +920,29 @@ func (s *MeetingService) SendChatMessage(ctx context.Context, userID int64, code
 		return nil, err
 	}
 
+	// Redis 滑窗限流（INCR + EXPIRE 组合；首条消息初始化窗口）
+	// 失败时仅 Warn 并放行，避免 Redis 抖动影响用户发消息
+	rateKey := fmt.Sprintf("%s%s:%d", redisKeyChatRatePrefix, code, userID)
+	cnt, rErr := s.redis.Incr(ctx, rateKey).Result()
+	if rErr != nil {
+		logs.Warn(ctx, funcName, "聊天限流 INCR 失败（放行）",
+			zap.String("key", rateKey), zap.Error(rErr))
+	} else {
+		if cnt == 1 {
+			_ = s.redis.Expire(ctx, rateKey, time.Duration(constants.MeetingChatRateLimitWindowS)*time.Second).Err()
+		}
+		if cnt > int64(constants.MeetingChatRateLimitPerMin) {
+			logs.Warn(ctx, funcName, "聊天限流触发",
+				zap.String("room_code", code), zap.Int64("user_id", userID),
+				zap.Int64("count_in_window", cnt), zap.Int("limit", constants.MeetingChatRateLimitPerMin))
+			return nil, ErrChatRateLimited
+		}
+	}
+
 	chat := &model.MeetingChat{
 		RoomID:  room.ID,
 		UserID:  userID,
-		Content: content,
+		Content: trimmed,
 	}
 	if err := s.chatDAO.Create(ctx, chat); err != nil {
 		return nil, err
@@ -903,7 +957,7 @@ func (s *MeetingService) SendChatMessage(ctx context.Context, userID int64, code
 		"user_id":     userID,
 		"user_name":   userName,
 		"user_avatar": userAvatar,
-		"content":     content,
+		"content":     trimmed,
 		"created_at":  chat.CreatedAt.Format("2006-01-02 15:04:05"),
 	}, userID)
 

backend/go-service/app/meeting/service/meeting_signal_service.go

@@ -5,6 +5,7 @@ import (
 	"context"
 	"encoding/json"
 	"fmt"
+	"strings"
 	"time"
 
 	"github.com/echochat/backend/app/constants"
@@ -70,7 +71,8 @@ func memberStateKey(roomCode string, userID int64) string {
 
 // resourceTTL 单个用户资源追踪集合 TTL
 // 设计：会议期间维持可达即可；若用户长期不活跃由断线清理接管
-const resourceTTL = time.Hour
+// Task 16 Nit：常量已迁出至 constants.MeetingResourceTrackTTLSeconds，此处保留计算式 wrapper 方便调用侧零改动
+var resourceTTL = time.Duration(constants.MeetingResourceTrackTTLSeconds) * time.Second
 
 // trackResource 记录用户在会议中持有的媒体资源 ID
 func (s *MeetingSignalService) trackResource(ctx context.Context, roomCode string, userID int64, kind, id string) {
@@ -265,17 +267,12 @@ func (s *MeetingSignalService) pushExistingProducers(ctx context.Context, roomID
 		}
 		for _, m := range members {
 			// 格式："kind:id"；仅关心 producer
-			idx := -1
-			for j, c := range m {
-				if c == ':' {
-					idx = j
-					break
-				}
-			}
-			if idx < 0 {
+			// Nit（代码审查 2026-04-23）：改用 strings.SplitN，避免 rune 解码开销
+			parts := strings.SplitN(m, ":", 2)
+			if len(parts) != 2 {
 				continue
 			}
-			kind, id := m[:idx], m[idx+1:]
+			kind, id := parts[0], parts[1]
 			if kind != "producer" || id == "" {
 				continue
 			}
@@ -410,10 +407,12 @@ func (s *MeetingSignalService) OnRoomLeave(ctx context.Context, userID int64, ro
 	}
 	s.cleanupUserResources(ctx, roomCode, userID)
 
+	// P2-8 修复：使用常量 MeetingLeftReasonDisconnect，避免 "ws_disconnect" 等硬编码
+	// 与前端 MEETING_LEFT_REASON_LABEL 字面值不一致
 	go s.broadcaster.BroadcastToMeeting(logs.DetachContext(ctx), room.ID, constants.MeetingWSEventMemberLeft, map[string]interface{}{
 		"room_code": roomCode,
 		"user_id":   userID,
-		"reason":    "ws_disconnect",
+		"reason":    constants.MeetingLeftReasonDisconnect,
 	}, userID)
 	return nil
 }
@@ -678,23 +677,21 @@ func (s *MeetingSignalService) cleanupUserResources(ctx context.Context, roomCod
 	}
 	for _, m := range members {
 		// 格式："kind:id"
-		idx := -1
-		for i, c := range m {
-			if c == ':' {
-				idx = i
-				break
-			}
-		}
-		if idx < 0 {
+		// Nit（代码审查 2026-04-23）：原先使用 for-range + rune 匹配 ':'，对 ASCII 过度包装；
+		// 改用 strings.SplitN 限定 2 段更清晰，且避免 rune 解码开销
+		parts := strings.SplitN(m, ":", 2)
+		if len(parts) != 2 {
 			continue
 		}
-		kind, id := m[:idx], m[idx+1:]
+		kind, id := parts[0], parts[1]
 		switch kind {
 		case "producer":
 			_ = s.mediaOrchestrator.CloseProducer(ctx, id)
 		case "consumer":
 			_ = s.mediaOrchestrator.CloseConsumer(ctx, id)
-			// transport 关闭一般由 Router 级联；这里不单独处理
+		case "transport":
+			// Task 16 P2-1：补全 transport 精确清理，短暂抖动重连场景下 Router 不会级联关闭自己的 transport
+			_ = s.mediaOrchestrator.CloseTransport(ctx, id)
 		}
 	}
 	_ = s.redis.Del(ctx, key).Err()

backend/go-service/app/provider/provider.go

@@ -156,12 +156,19 @@ func provideMinioConfig(cfg *config.Config) *config.MinioConfig {
 	return &cfg.Minio
 }
 
+// provideServerConfig 从全局 Config 中提取 ServerConfig
+// Task 16 Nit：WebSocket CheckOrigin 白名单收敛需要 server.ws_allowed_origins + server.mode
+func provideServerConfig(cfg *config.Config) *config.ServerConfig {
+	return &cfg.Server
+}
+
 // InfraSet 基础设施层 Provider Set
 var InfraSet = wire.NewSet(
 	provideDBConfig,
 	provideRedisConfig,
 	provideJWTConfig,
 	provideMinioConfig,
+	provideServerConfig,
 	db.NewPostgres,
 	db.NewRedis,
 	storage.NewMinioClient,

backend/go-service/app/provider/wire_gen.go

@@ -80,7 +80,8 @@ func InitializeApp(cfg *config.Config) (*App, error) {
 	conversationDAO := im.ProvideConversationDAO(gormDB)
 	messageManageService := service2.NewMessageManageService(messageManageDAO, userDAO, conversationDAO, pubSub)
 	messageManageController := controller2.NewMessageManageController(messageManageService)
-	handler := ws.ProvideWSHandler(hub, pubSub, jwtConfig, onlineService, authService)
+	serverConfig := provideServerConfig(cfg)
+	handler := ws.ProvideWSHandler(hub, pubSub, jwtConfig, serverConfig, onlineService, authService)
 	friendGroupDAO := dao3.NewFriendGroupDAO(gormDB)
 	notificationDAO := dao5.NewNotificationDAO(gormDB)
 	notifyService := service3.NewNotifyService(notificationDAO, pubSub, friendshipDAO)

backend/go-service/app/ws/handler.go

@@ -5,6 +5,8 @@ package ws
 import (
 	"context"
 	"net/http"
+	"net/url"
+	"strings"
 
 	"github.com/echochat/backend/config"
 	"github.com/echochat/backend/pkg/logs"
@@ -44,35 +46,80 @@ type MeetingDisconnectHook interface {
 	OnWSDisconnect(ctx context.Context, userID int64)
 }
 
-var upgrader = websocket.Upgrader{
-	ReadBufferSize:  1024,
-	WriteBufferSize: 1024,
-	CheckOrigin: func(r *http.Request) bool {
-		return true // TODO: 生产环境通过配置限制 allowed origins
-	},
-}
-
 // Handler WebSocket 连接处理器
 type Handler struct {
 	hub                   *ws.Hub
 	pubsub                *ws.PubSub
 	jwtCfg                *config.JWTConfig
+	serverCfg             *config.ServerConfig // Task 16 Nit：CheckOrigin 白名单需要
 	onlineService         *OnlineService
 	tokenValidator        TokenValidator
 	offlinePusher         OfflineMessagePusher
 	notifyConnectHook     NotifyConnectHook
 	meetingDisconnectHook MeetingDisconnectHook // Task 8 注入
+	upgrader              websocket.Upgrader
 }
 
 // NewHandler 创建 WebSocket Handler 实例
-func NewHandler(hub *ws.Hub, pubsub *ws.PubSub, jwtCfg *config.JWTConfig, onlineService *OnlineService, tokenValidator TokenValidator) *Handler {
-	return &Handler{
+// Task 16 Nit：新增 serverCfg 参数，按 server.ws_allowed_origins + server.mode 收敛 CheckOrigin
+func NewHandler(hub *ws.Hub, pubsub *ws.PubSub, jwtCfg *config.JWTConfig, serverCfg *config.ServerConfig, onlineService *OnlineService, tokenValidator TokenValidator) *Handler {
+	h := &Handler{
 		hub:            hub,
 		pubsub:         pubsub,
 		jwtCfg:         jwtCfg,
+		serverCfg:      serverCfg,
 		onlineService:  onlineService,
 		tokenValidator: tokenValidator,
 	}
+	h.upgrader = websocket.Upgrader{
+		ReadBufferSize:  1024,
+		WriteBufferSize: 1024,
+		CheckOrigin:     h.checkOrigin,
+	}
+	return h
+}
+
+// checkOrigin 按配置收敛 WebSocket 握手 Origin：
+//   - 同源（Origin 为空 或 Origin.Host == Request.Host）→ 放行
+//   - dev 模式（server.mode != release）+ 未配置白名单 → 放行全部（便于本地开发调试）
+//   - release 模式 / 配置了白名单 → 仅放行白名单匹配的 Origin
+//
+// 精确匹配 scheme+host+port，不做前缀/通配，避免误匹配
+func (h *Handler) checkOrigin(r *http.Request) bool {
+	origin := strings.TrimSpace(r.Header.Get("Origin"))
+	// 空 Origin：非浏览器场景（如 curl / server-to-server），默认放行
+	if origin == "" {
+		return true
+	}
+	u, err := url.Parse(origin)
+	if err != nil || u.Host == "" {
+		logs.Warn(r.Context(), "ws.handler.checkOrigin", "Origin 非法，拒绝",
+			zap.String("origin", origin))
+		return false
+	}
+	// 同源（Origin.Host == Request.Host）直接放行
+	if strings.EqualFold(u.Host, r.Host) {
+		return true
+	}
+	allowed := h.serverCfg.AllowedOrigins()
+	// 未配置白名单：dev 放行，release 拒绝
+	if len(allowed) == 0 {
+		if h.serverCfg.IsRelease() {
+			logs.Warn(r.Context(), "ws.handler.checkOrigin", "release 模式未配置 WSAllowedOrigins，拒绝跨源",
+				zap.String("origin", origin))
+			return false
+		}
+		return true
+	}
+	// 精确匹配白名单
+	for _, ao := range allowed {
+		if strings.EqualFold(ao, origin) {
+			return true
+		}
+	}
+	logs.Warn(r.Context(), "ws.handler.checkOrigin", "Origin 不在白名单，拒绝",
+		zap.String("origin", origin))
+	return false
 }
 
 // SetOfflinePusher 设置离线消息推送器（由 IM 模块在初始化时注入）
@@ -120,7 +167,7 @@ func (h *Handler) Upgrade(c *gin.Context) {
 		return
 	}
 
-	conn, err := upgrader.Upgrade(c.Writer, c.Request, nil)
+	conn, err := h.upgrader.Upgrade(c.Writer, c.Request, nil)
 	if err != nil {
 		logs.Error(nil, funcName, "WebSocket 升级失败",
 			zap.Int64("user_id", claims.UserID), zap.Error(err))

backend/go-service/app/ws/provider.go

@@ -26,8 +26,9 @@ func ProvideOnlineService(rdb *redis.Client, hub *ws.Hub, pubsub *ws.PubSub, fri
 }
 
 // ProvideWSHandler 创建 WebSocket Handler
-func ProvideWSHandler(hub *ws.Hub, pubsub *ws.PubSub, cfg *config.JWTConfig, onlineService *OnlineService, tokenValidator TokenValidator) *Handler {
-	return NewHandler(hub, pubsub, cfg, onlineService, tokenValidator)
+// Task 16 Nit：新增 ServerConfig 入参，用于 WS 握手 Origin 白名单
+func ProvideWSHandler(hub *ws.Hub, pubsub *ws.PubSub, jwtCfg *config.JWTConfig, serverCfg *config.ServerConfig, onlineService *OnlineService, tokenValidator TokenValidator) *Handler {
+	return NewHandler(hub, pubsub, jwtCfg, serverCfg, onlineService, tokenValidator)
 }
 
 // WSSet WebSocket 模块 Wire Provider Set

backend/go-service/config/config.dev.yaml

@@ -60,9 +60,10 @@ minio:
 media_server:
   base_url: "http://localhost:3300"          # media-server 基础 URL（不含末尾斜杠）
   internal_token: "dev-token-abcdef1234567890"   # 与 media-server/.env MEDIA_INTERNAL_TOKEN 一致（开发环境）
-  timeout_ms: 5000                           # 创建类接口超时（毫秒）
+  timeout_ms: 10000                          # 创建类接口超时（毫秒）；Task 16 Nit：5000 → 10000 兼容 Worker 冷启动
   close_timeout_ms: 2000                     # 关闭类接口超时（毫秒）
   close_retry: 2                             # 关闭类接口失败重试次数（指数退避 200/500ms）
+  create_router_retry: 1                     # Task 16 Nit：CreateRouter 在 5xx/网络错误时的额外重试次数（默认 1 次，退避 300ms）
 
 # 会议模块生命周期参数（Phase 2e-2 Task 8 会议状态机）
 # E2E 测试可通过环境变量 ECHOCHAT_MEETING_HOST_GRACE_SECONDS 等覆盖为更短值以加速触发

backend/go-service/config/config.docker.yaml

@@ -52,9 +52,10 @@ minio:
 media_server:
   base_url: "http://media-server:3300"            # Docker 网络内服务名
   internal_token: "dev-internal-token-change-me"  # 生产环境通过 ECHOCHAT_MEDIA_SERVER_INTERNAL_TOKEN 覆盖
-  timeout_ms: 5000
+  timeout_ms: 10000        # Task 16 Nit：5000 → 10000 兼容 Worker 冷启动
   close_timeout_ms: 2000
   close_retry: 2
+  create_router_retry: 1   # Task 16 Nit：CreateRouter 在 5xx/网络错误时的额外重试次数
 
 # 会议模块生命周期参数（Phase 2e-2 Task 8）
 meeting:

backend/go-service/config/config.go

@@ -34,11 +34,12 @@ type MeetingConfig struct {
 // 与 media-server/.env 中的 MEDIA_INTERNAL_TOKEN / HTTP_PORT 成对使用
 // BaseURL 需精确到协议与端口：http://host:port，不含末尾斜杠
 type MediaServerConfig struct {
-	BaseURL        string `mapstructure:"base_url"`         // 如 http://localhost:3300
-	InternalToken  string `mapstructure:"internal_token"`   // 与 Node 共享密钥
-	TimeoutMS      int    `mapstructure:"timeout_ms"`       // 创建类接口超时（毫秒），默认 5000
-	CloseTimeoutMS int    `mapstructure:"close_timeout_ms"` // 关闭类接口超时（毫秒），默认 2000
-	CloseRetry     int    `mapstructure:"close_retry"`      // 关闭类接口失败重试次数，默认 2
+	BaseURL           string `mapstructure:"base_url"`            // 如 http://localhost:3300
+	InternalToken     string `mapstructure:"internal_token"`      // 与 Node 共享密钥
+	TimeoutMS         int    `mapstructure:"timeout_ms"`          // 创建类接口超时（毫秒），默认 10000
+	CloseTimeoutMS    int `mapstructure:"close_timeout_ms"`    // 关闭类接口超时（毫秒），默认 2000
+	CloseRetry        int `mapstructure:"close_retry"`         // 关闭类接口失败重试次数，默认 2
+	CreateRouterRetry int `mapstructure:"create_router_retry"` // Task 16 Nit：CreateRouter 5xx/网络错误时的重试次数，默认 1
 }
 
 // MinioConfig MinIO 对象存储配置
@@ -54,6 +55,31 @@ type MinioConfig struct {
 type ServerConfig struct {
 	Port int    `mapstructure:"port"` // 监听端口
 	Mode string `mapstructure:"mode"` // 运行模式: debug/release
+	// Task 16 Nit：WebSocket 升级握手 Origin 白名单（逗号分隔）
+	// - 空串 → dev 模式（mode != release）放行全部，release 模式强制拒绝所有跨源（仅同源可建连）
+	// - 配置示例："https://app.example.com,http://localhost:5173"
+	// - 环境变量覆盖：ECHOCHAT_SERVER_WS_ALLOWED_ORIGINS="https://a.com,https://b.com"
+	WSAllowedOrigins string `mapstructure:"ws_allowed_origins"`
+}
+
+// AllowedOrigins 将逗号分隔的 WSAllowedOrigins 解析为 slice，已去空并 trim
+func (s *ServerConfig) AllowedOrigins() []string {
+	if s.WSAllowedOrigins == "" {
+		return nil
+	}
+	raw := strings.Split(s.WSAllowedOrigins, ",")
+	out := make([]string, 0, len(raw))
+	for _, o := range raw {
+		if v := strings.TrimSpace(o); v != "" {
+			out = append(out, v)
+		}
+	}
+	return out
+}
+
+// IsRelease 判断是否为生产运行模式
+func (s *ServerConfig) IsRelease() bool {
+	return strings.EqualFold(s.Mode, "release")
 }
 
 // DatabaseConfig PostgreSQL 数据库配置