node.js内存泄漏需用跨平台方式定位：先--inspect和--trace-gc启动，再chrome devtools拍两次堆快照对比，聚焦retained size与retainers链，sharp泄漏须禁用缓存、每次调destroy并避免buffer隐式引用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在 Win/Mac 双平台开发 Codex 项目时，Node.js 进程内存持续上涨、响应变慢、甚至偶发 OOM 崩溃，却找不到明确的泄漏点——这不是配置问题，而是未被识别的引用链正在 silently 拖垮服务。必须用跨平台兼容的方式定位真实泄漏源，而非依赖单一系统行为。
启动带调试能力的 Node 进程
第一步：在项目根目录执行 node --inspect=9229 --trace-gc app.js。--inspect 参数确保 Chrome DevTools 可连接，--trace-gc 则强制输出每次 GC 的时间与内存变化，这是判断泄漏是否存在最直接的信号。
第二步：打开 Chrome 浏览器，访问 chrome://inspect → 点击“Open dedicated DevTools for Node” → 在“Memory”面板中点击“Take heap snapshot”。这一步必须在服务空闲期（无请求）执行，否则快照会混入大量临时对象，干扰分析。
第三步：向服务发送一组稳定复现路径的请求（例如反复调用 /genLuckyBagCover），等待内存明显增长后，再拍第二份堆快照。两次快照之间不要重启进程，否则引用链断裂，无法对比。
用 Chrome DevTools 定位泄漏对象
进入 Memory 面板 → 左侧选择第二份快照 → 点击右上角“Comparison” → 选择第一份快照作为对比基准。
重点看 “# New” 和 “# Deleted” 列：若某类对象（如 Buffer、SharpImage、Map）的 # New 值远高于 # Deleted，且 Distance（到 GC 根距离）普遍为 1～3，则极大概率是泄漏源。
点击该构造函数名 → 右侧 Retainers 标签页展开引用链 → 找到第一个非系统模块的 JS 调用位置。比如看到 sharp/lib/vips → module.exports → app.js:42，说明泄漏源头就在 app.js 第 42 行创建 sharp 实例的位置。
【注意：不要直接信任“shallow size”，要盯住 “retained size” —— 它代表该对象及其所有被它强引用的对象总内存占用】
验证并确认动态依赖是否真实可用
方法一：全局搜索字符串式 require/import
在终端执行：grep -r "require.*[" src/ | grep -v "node_modules/"。如果返回类似 require(pkgName) 或 import(`${pkgName}/index.js`) 的结果，depcheck 会漏判，这些包不能删。
方法二：检查 Webpack 配置中的 externals 和 resolve.alias
打开 webpack.config.js，查找 externals 字段（如 { 'lodash': '_' }）或 resolve.alias（如 { '@utils': './src/utils' }）。这些配置会让模块在运行时从外部注入或重定向路径，代码里没 import 但实际被用了。
方法三：检查 package.json scripts 中调用的 CLI 工具
查看 "scripts": { "lint": "eslint .", "format": "prettier --write ." } 这类字段。eslint、prettier 等属于“运行时脚本依赖”，即使源码没 import，也不能从 devDependencies 删除。
针对性修复 sharp 引发的内存泄漏
第一步：禁用 libvips 缓存层，在初始化 sharp 时显式设置：
const sharp = require('sharp');
sharp.cache(false); // 必须放在任何图像处理操作之前
第二步：每次图像处理完成后立即调用 .destroy()，释放 C++ 层资源：
await sharp(input).resize(200).toBuffer();
sharp.cache(false); // 再次确认缓存已关
sharp.destroy(); // 主动释放 libvips 分配的内存，不等 GC
【关键：sharp.destroy() 必须在每个独立图像处理流程末尾调用，不能只在进程退出时调一次】
第三步：避免 Buffer 在 Promise 链中隐式持有引用。改写如下：
错误写法：const buf = await sharp(img).png().toBuffer(); return buf;
正确写法：return await sharp(img).png().toBuffer().finally(() => sharp.destroy()); —— 确保无论成功失败都释放资源。
