c35097a0d8
覆盖 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
75 lines
4.1 KiB
YAML
75 lines
4.1 KiB
YAML
# ============================================================
|
||
# EchoChat 开发环境配置
|
||
# 环境变量覆盖规则：ECHOCHAT_{节}_{字段} 如 ECHOCHAT_SERVER_PORT=9090
|
||
# ============================================================
|
||
|
||
# HTTP 服务配置
|
||
server:
|
||
port: 8085 # 服务监听端口
|
||
mode: debug # 运行模式：debug（开发）/ release（生产）
|
||
|
||
# PostgreSQL 数据库配置
|
||
database:
|
||
host: localhost # 数据库地址
|
||
port: 5432 # 数据库端口
|
||
user: echochat # 数据库用户名
|
||
password: echochat_dev_2026 # 数据库密码
|
||
dbname: echochat # 数据库名称
|
||
sslmode: disable # SSL 模式：disable（开发）/ require（生产）
|
||
max_idle_conns: 10 # 连接池最大空闲连接数
|
||
max_open_conns: 100 # 连接池最大打开连接数
|
||
|
||
# Redis 配置
|
||
redis:
|
||
host: localhost # Redis 地址
|
||
port: 6379 # Redis 端口
|
||
password: "" # Redis 密码，开发环境为空
|
||
db: 0 # Redis 数据库编号（0-15）
|
||
|
||
# JWT 认证配置
|
||
jwt:
|
||
secret: echochat-dev-jwt-secret-2026-please-change-in-production # JWT 签名密钥，生产环境必须更换
|
||
access_expire_min: 120 # Access Token 有效期（分钟），即 2 小时
|
||
refresh_expire_day: 7 # Refresh Token 有效期（天），即 7 天
|
||
issuer: echochat # JWT 签发者标识
|
||
|
||
# 日志配置
|
||
log:
|
||
level: debug # 最低输出级别：debug / info / warn / error
|
||
format: text # 控制台输出格式：text（彩色可读）/ json（结构化）
|
||
output_path: stdout # 控制台输出目标（保留字段，始终输出到 stdout）
|
||
file:
|
||
enable: true # 是否启用日志文件输出（true 时同时写入控制台和文件）
|
||
dir: logs # 日志文件存放目录（相对于 go-service 工作目录）
|
||
max_size: 50 # 单个日志文件最大大小（MB），超过后自动切割产生新文件
|
||
max_backups: 10 # 保留的旧日志归档文件最大数量，超出的自动删除
|
||
max_age: 30 # 旧日志归档文件保留天数，超过天数的自动删除
|
||
compress: false # 是否对归档的旧日志文件进行 gzip 压缩（生产环境建议 true）
|
||
|
||
# MinIO 对象存储配置
|
||
minio:
|
||
endpoint: "localhost:9000" # MinIO 服务地址
|
||
access_key: "echochat" # 访问密钥（与 docker-compose 中的 MINIO_ROOT_USER 一致）
|
||
secret_key: "echochat123456" # 密钥（与 docker-compose 中的 MINIO_ROOT_PASSWORD 一致）
|
||
bucket: "echochat" # 存储桶名称
|
||
use_ssl: false # 开发环境不使用 HTTPS
|
||
|
||
# Node media-server 接入配置（Phase 2e-2 Task 7 HTTPMediaOrchestrator）
|
||
# 对应 media-server/.env 的 MEDIA_INTERNAL_TOKEN + HTTP_PORT（默认 3300）
|
||
# 生产环境通过环境变量 ECHOCHAT_MEDIA_SERVER_INTERNAL_TOKEN 覆盖
|
||
media_server:
|
||
base_url: "http://localhost:3300" # media-server 基础 URL（不含末尾斜杠）
|
||
internal_token: "dev-token-abcdef1234567890" # 与 media-server/.env MEDIA_INTERNAL_TOKEN 一致（开发环境）
|
||
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 等覆盖为更短值以加速触发
|
||
meeting:
|
||
host_grace_seconds: 120 # 主持人掉线宽限期（秒），期间保留 host 身份
|
||
empty_room_ttl_seconds: 300 # 空房自动销毁 TTL（秒），期间有人加入可复活
|
||
cleanup_interval_seconds: 30 # 兜底扫描周期（秒），定时任务检查过期 grace/empty_ttl key
|
||
stale_room_hours: 4 # 活跃超过此小时且无活跃成员视为 stale，强制结束
|