import v8 from 'node:v8' import { logInfo } from '../utils/logger.js' /** * 周期性记录进程内存快照,用于判断 backend 容器内存是"正常 GC 曲线"还是"持续增长"。 * * 为什么需要它:生产上 backend 限额 768MB,重启后 194MB,十天后贴到 754MB(98%), * 之后整个服务明显变慢——但仅凭容器数字分不清是 V8 贴近 cgroup 上限导致 GC 抖动, * 还是真有增长点。有了这份日志就能对比: * - rssMb 长期单调上升、重启后回落明显 → 存在增长点(缓存/事件缓冲/连接堆积); * - rssMb 稳定、heapUsedMb 上下波动 → 正常 GC 曲线,调限额即可。 * * 每 10 分钟一条,logger 内部已有按天滚动与 30 天保留,不会堆积。 */ const MEMORY_REPORT_INTERVAL_MS = 10 * 60 * 1000 function toMb(bytes: number): number { return Math.round((Number(bytes) || 0) / 1024 / 1024) } export function startMemoryReporter(): NodeJS.Timeout { const report = () => { const usage = process.memoryUsage() logInfo('[memory]', '进程内存快照', { rssMb: toMb(usage.rss), heapUsedMb: toMb(usage.heapUsed), heapTotalMb: toMb(usage.heapTotal), externalMb: toMb(usage.external), arrayBuffersMb: toMb(usage.arrayBuffers || 0), heapLimitMb: toMb(v8.getHeapStatistics().heap_size_limit), }) } report() const timer = setInterval(report, MEMORY_REPORT_INTERVAL_MS) // 不因为这个定时器把进程钉在事件循环里(关闭流程/测试环境都受益) timer.unref() return timer }