Files
EchoChat/media-server/src/config.ts
bujinyuan 6e2e792db0 feat(phase2e-2): media-server Task 0/1/2 落地 + 代码审查修复
本次提交一次性落盘 Phase 2e-2 的 Task 0(PoC Spike)、Task 1(骨架 + Fastify 5 升级)
和 Task 2(9 个内部 REST API + code-reviewer 审查修复),覆盖 media-server 子项目
从零到可用的全部工作。

【Task 0 - PoC Spike】
- media-server/poc/:Node + mediasoup + fastify-websocket + 前端 mediasoup-client
- Playwright 双 tab 自动化验证 2 人会议:4 transports / 4 producers / 4 consumers / RSS 61MB
- media-server/docs/poc-notes.md 归档 7 项关键坑 + 启动步骤 + Task 1/2/9 复用映射
- 锁定技术栈:mediasoup + fastify + mediasoup-client,不改用 livekit-server

【Task 1 - 骨架 + Fastify 5 升级】
- 依赖版本:mediasoup@3.19.0 + fastify@5.8.5 + fastify-plugin@5.1.0
           + @fastify/sensible@6.0.4 + @fastify/websocket@11.2.0
           + pino@9.3.2 + zod@3.23.8
- src 五件套:app.ts / config.ts / utils/logger.ts / mediasoup/worker.ts
             / middlewares/internal-auth.ts
- /healthz + /readyz + /internal/info 三端点实测通过
- X-Internal-Token 鉴权用 timingSafeEqual 防侧信道
- mediasoup Worker died 指数退避自愈通过 kill -9 验证
- 多阶段 Dockerfile:非 root + curl HEALTHCHECK + 暴露 40000-40199 UDP/TCP
- Fastify 4 → 5 升级:loggerInstance: logger 消灭两个 pino 实例

【Task 2 - 9 个内部 REST API + 审查修复】
接口全部挂 /internal/v1/* 前缀,覆盖 Router/Transport/Producer/Consumer 完整生命周期:
- POST /routers, DELETE /routers/:id
- POST /transports, POST /transports/:id/connect
- POST /producers, DELETE /producers/:id
- POST /consumers, POST /consumers/:id/resume, DELETE /consumers/:id

工程特性:
- zod 手动 parse + 全局 errorHandler(不引入 fastify-type-provider-zod 避免
  zod v4 依赖冲突)
- AppError 统一错误码(NOT_FOUND/CONFLICT/CAN_NOT_CONSUME/ROUTER_LIMIT_EXCEEDED
  /MEDIASOUP_ERROR/VALIDATION_ERROR/UNAUTHORIZED/INTERNAL_ERROR)
- 所有资源用 Map + observer.once('close') 自清理,Consumer 监听 producerclose 级联关闭
- Consumer 强制 paused:true 创建,/resume 独立接口
- Transport direction 强约束:recv 拒 produce、send 拒 consume

code-reviewer 子代理审查"有条件通过",同步修复:
- M1 _clearXxxMap 新增 src/utils/test-guard.ts#assertTestOnly 守卫(生产误调用抛错)
- M2 新增 src/schemas/rtp.ts 对 rtpParameters / rtpCapabilities 做 codecs 浅层校验
  (mimeType/clockRate/payloadType 必填、codecs ≥1),消除 as unknown as 双跳断言
- m1 connectTransport 改乐观锁:先置位再 await,失败回退
- m2 改读 consumer.producerPaused(更符合 mediasoup 语义)
- m3 producerclose 改为 once(风格一致)
- m5 internal-auth 改为反向白名单 PRIVATE_PATH_PREFIXES = ['/internal/']

验证:
- typecheck / lint 0 错误
- vitest:65 passed / 8 spec 文件
- 覆盖率 stmts 82.87% / branches 75.83% / funcs 91.3% / lines 82.87%
- 9 接口 happy path + 6 类错误路径 curl 手测全部按预期返回

【文档同步】
- CURRENT_STATUS.md +232 行:新增 Task 0/1/2 完整记录 + 代码审查修复章节 + 延后清单
- project-context.mdc:Task 0/1/2 状态同步
- phase2e-2-design.md +20 行:Fastify 5 升级相关决策记录
- phase2e-2-implementation.plan.md +117 行:Task 0/1/2 实际产出 + 修复记录

余下 Minor/Nits(m4/m6~m10/n1~n10)登记至 Task 16 收尾清单一次性清扫。

Made-with: Cursor
2026-04-21 15:31:01 +08:00

126 lines
3.5 KiB
TypeScript

import { existsSync, readFileSync } from 'node:fs';
import { resolve } from 'node:path';
import { z } from 'zod';
function loadDotEnv(): void {
const envPath = resolve(process.cwd(), '.env');
if (!existsSync(envPath)) {
return;
}
const raw = readFileSync(envPath, 'utf-8');
for (const line of raw.split(/\r?\n/)) {
const trimmed = line.trim();
if (!trimmed || trimmed.startsWith('#')) {
continue;
}
const eq = trimmed.indexOf('=');
if (eq <= 0) {
continue;
}
const key = trimmed.slice(0, eq).trim();
let value = trimmed.slice(eq + 1).trim();
if (
(value.startsWith('"') && value.endsWith('"')) ||
(value.startsWith("'") && value.endsWith("'"))
) {
value = value.slice(1, -1);
}
if (process.env[key] === undefined) {
process.env[key] = value;
}
}
}
loadDotEnv();
const booleanSchema = z
.union([z.string(), z.boolean()])
.transform((val) => {
if (typeof val === 'boolean') return val;
const lowered = val.toLowerCase();
return lowered === '1' || lowered === 'true' || lowered === 'yes' || lowered === 'on';
});
const envSchema = z
.object({
NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
HTTP_HOST: z.string().min(1).default('0.0.0.0'),
HTTP_PORT: z.coerce.number().int().min(1).max(65535).default(3300),
LOG_LEVEL: z
.enum(['trace', 'debug', 'info', 'warn', 'error', 'fatal', 'silent'])
.default('info'),
LOG_PRETTY: booleanSchema.default('true'),
MEDIA_INTERNAL_TOKEN: z
.string()
.min(8, 'MEDIA_INTERNAL_TOKEN must be at least 8 characters'),
MEDIASOUP_LISTEN_IP: z.string().min(1).default('0.0.0.0'),
MEDIASOUP_ANNOUNCED_IP: z
.string()
.optional()
.transform((v) => (v && v.trim() !== '' ? v.trim() : undefined)),
MEDIASOUP_RTC_MIN_PORT: z.coerce.number().int().min(1024).max(65535).default(40000),
MEDIASOUP_RTC_MAX_PORT: z.coerce.number().int().min(1024).max(65535).default(40199),
MEDIASOUP_WORKER_LOG_LEVEL: z
.enum(['debug', 'warn', 'error', 'none'])
.default('warn'),
MEDIASOUP_MAX_ROUTERS: z.coerce.number().int().min(1).default(200),
})
.superRefine((data, ctx) => {
if (data.MEDIASOUP_RTC_MIN_PORT >= data.MEDIASOUP_RTC_MAX_PORT) {
ctx.addIssue({
code: z.ZodIssueCode.custom,
path: ['MEDIASOUP_RTC_MAX_PORT'],
message: 'MEDIASOUP_RTC_MAX_PORT must be greater than MEDIASOUP_RTC_MIN_PORT',
});
}
});
function parseEnv() {
const parsed = envSchema.safeParse(process.env);
if (!parsed.success) {
const issues = parsed.error.issues
.map((issue) => ` - ${issue.path.join('.')}: ${issue.message}`)
.join('\n');
// eslint-disable-next-line no-console
console.error(`[media-server] Invalid environment configuration:\n${issues}`);
process.exit(1);
}
return parsed.data;
}
const env = parseEnv();
export const config = {
nodeEnv: env.NODE_ENV,
isProduction: env.NODE_ENV === 'production',
http: {
host: env.HTTP_HOST,
port: env.HTTP_PORT,
},
logLevel: env.LOG_LEVEL,
logPretty: env.LOG_PRETTY,
internalToken: env.MEDIA_INTERNAL_TOKEN,
mediasoup: {
listenIp: env.MEDIASOUP_LISTEN_IP,
announcedIp: env.MEDIASOUP_ANNOUNCED_IP,
rtcMinPort: env.MEDIASOUP_RTC_MIN_PORT,
rtcMaxPort: env.MEDIASOUP_RTC_MAX_PORT,
workerLogLevel: env.MEDIASOUP_WORKER_LOG_LEVEL,
maxRouters: env.MEDIASOUP_MAX_ROUTERS,
},
} as const;
export type AppConfig = typeof config;