Node.js内置诊断报告可快速定位性能问题，通过命令行或API启用，支持异常退出或信号触发生成包含事件循环延迟、内存使用、活跃句柄和调用栈等关键信息的JSON报告，结合监控系统实现自动采样与告警，有助于分析卡顿、内存泄漏等问题，提升生产环境排查效率。
Node.js 内置的诊断报告功能是排查生产环境性能问题的有力工具，无需额外依赖，就能生成包含堆栈、事件循环延迟、内存使用等关键信息的报告。通过合理配置和触发机制，可以快速定位卡顿、内存泄漏或高 CPU 使用等问题。
启用诊断报告并配置生成条件
从 Node.js 12 开始，可通过命令行或 API 启用诊断报告。在启动应用时添加以下参数：
node --diagnostic-report-enabled \ --diagnostic-report-filename=report.json \ --diagnostic-report-directory=/var/log/app app.js这样会在进程异常退出时自动生成报告。你也可以设置在收到特定信号时生成：
node --diagnostic-report-signal=SIGUSR2 app.js发送 SIGUSR2 信号即可手动触发报告生成，适合在发现服务变慢时主动采集现场数据。
通过 API 主动创建诊断报告
在代码中引入 diagnostics_report 模块，可在关键路径或监控判断后主动输出报告：
const report = require('diagnostics_report'); // 例如在检测到响应时间过长时调用 if (responseTime > 5000) { report.writeReport(); }还可自定义报告内容，加入上下文信息：
report.writeReport({ message: 'High latency detected', trigger: 'manual-trigger' });
分析报告中的关键性能指标
生成的 JSON 报告包含多个对性能分析有用的字段：
- eventLoopDelay：反映事件循环阻塞情况，数值越大说明主线程被长时间任务占用
- heap 和 memoryUsage：查看堆内外内存使用，判断是否存在内存泄漏
- activeHandles：列出当前活跃的资源句柄（如定时器、Socket），帮助发现未释放的连接
- stackTrace：在触发点的调用栈，有助于定位执行瓶颈
结合这些信息，比如发现 eventLoopDelay 长时间高于 100ms，基本可判定存在同步耗时操作；若堆内存持续增长且 GC 回收效果差，可能是对象未释放。
集成监控与自动化分析
将诊断报告与日志系统结合，定期采样或在指标异常时自动触发。例如使用 Prometheus 监控响应时间，一旦超标就调用 writeReport()，再通过脚本提取报告中的关键字段入库或告警。
也可编写简单脚本批量解析多个报告，统计高频调用栈或内存趋势，辅助长期性能优化。
基本上就这些。合理使用诊断报告，能大幅降低生产环境“黑盒”调试的难度，关键是提前启用、明确触发策略，并建立分析流程。不复杂但容易忽略。
