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 处 + 历次 commitcdaa39d/ea2bf96/f5ae095/ 5ed14c2) - 推迟登记表(P2-4 / P2-5 / 端口收敛 / appData 校验 / RFC3339 时间格式,共 5 项) Made-with: Cursor
This commit is contained in:
@@ -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)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user