NextJS部署AWS t3.medium实例JS堆内存溢出问题求助

问题背景 #

使用Next.js v14.2.7开发网站，部署在AWS t3.medium实例（4GiB内存）上，每约4天会触发实例崩溃告警，日志显示JavaScript堆内存溢出：

ssr-ui-1  | <--- Last few GCs --->
ssr-ui-1  | 
ssr-ui-1  | [114:0x6f85db0] 186260852 ms: Scavenge 1888.7 (1951.2) -> 1881.6 (1950.0) MB, 7.14 / 0.02 ms  (average mu = 0.923, current mu = 0.946) allocation failure; 
ssr-ui-1  | [114:0x6f85db0] 186260933 ms: Scavenge 1888.0 (1950.0) -> 1882.2 (1950.0) MB, 13.80 / 0.11 ms  (average mu = 0.923, current mu = 0.946) allocation failure; 
ssr-ui-1  | [114:0x6f85db0] 186261545 ms: Scavenge 1890.4 (1951.8) -> 1882.3 (1966.2) MB, 24.92 / 0.02 ms  (average mu = 0.923, current mu = 0.946) task; 
ssr-ui-1  | 
ssr-ui-1  | 
ssr-ui-1  | <--- JS stacktrace --->
ssr-ui-1  | 
ssr-ui-1  | FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory
ssr-ui-1  | ----- Native stack trace -----
ssr-ui-1  | 
ssr-ui-1  |  1: 0xb86ecf node::OOMErrorHandler(char const*, v8::OOMDetails const&) [next-server (v14.2.7)]
ssr-ui-1  |  2: 0xef74d0 v8::Utils::ReportOOMFailure(v8::internal::Isolate*, char const*, v8::OOMDetails const&) [next-server (v14.2.7)]
ssr-ui-1  |  3: 0xef77b7 v8::internal::V8::FatalProcessOutOfMemory(v8::internal::Isolate*, char const*, v8::OOMDetails const&) [next-server (v14.2.7)]
ssr-ui-1  |  4: 0x1109355  [next-server (v14.2.7)]
ssr-ui-1  |  5: 0x11211d8 v8::internal::Heap::CollectGarbage(v8::internal::AllocationSpace, v8::internal::GarbageCollectionReason, v8::GCCallbackFlags) [next-server (v14.2.7)]
ssr-ui-1  |  6: 0x1179dac v8::internal::MinorGCJob::Task::RunInternal() [next-server (v14.2.7)]
ssr-ui-1  |  7: 0xd3f5a6  [next-server (v14.2.7)]
ssr-ui-1  |  8: 0xd42b4f node::PerIsolatePlatformData::FlushForegroundTasksInternal() [next-server (v14.2.7)]
ssr-ui-1  |  9: 0x18b8913  [next-server (v14.2.7)]
ssr-ui-1  | 10: 0x18cd38b  [next-server (v14.2.7)]
ssr-ui-1  | 11: 0x18b9637 uv_run [next-server (v14.2.7)]
ssr-ui-1  | 12: 0xbcdbe6 node::SpinEventLoopInternal(node::Environment*) [next-server (v14.2.7)]
ssr-ui-1  | 13: 0xd13054  [next-server (v14.2.7)]
ssr-ui-1  | 14: 0xd13aed node::NodeMainInstance::Run() [next-server (v14.2.7)]
ssr-ui-1  | 15: 0xc77dbf node::Start(int, char**) [next-server (v14.2.7)]
ssr-ui-1  | 16: 0x7f7c47b0f24a  [/lib/x86_64-linux-gnu/libc.so.6]
ssr-ui-1  | 17: 0x7f7c47b0f305 __libc_start_main [/lib/x86_64-linux-gnu/libc.so.6]
ssr-ui-1  | 18: 0xbcae3e _start [next-server (v14.2.7)]

网站包含数十万页面，其中约1000个路由通过generateStaticParams传入空数组配置为ISR页面。正常运行时，执行docker stats可见访问ISR路由时Next.js容器内存占用上涨，但根据文档ISR页面应存储在磁盘，对此存在疑问。

已排除明显代码内存泄漏（如全局变量无限累加），临时禁用ISR页面观察是否缓解问题，同时提出以下疑问：

问题解答 #

1. 访问ISR页面时内存占用上涨的原因是什么？页面是否同时存储在内存和磁盘中？这属于预期行为吗？ #

• ISR页面确实会持久化到磁盘，但首次访问或缓存过期重新渲染时，Next.js会在内存中完成SSR渲染流程，生成的HTML、组件数据会短暂占用内存，直到写入磁盘后，部分数据才会被垃圾回收（GC）。
• 此外，Next.js默认会在内存中缓存近期访问过的ISR页面或其渲染上下文，减少重复磁盘IO，这是官方的优化策略，属于预期行为。如果短时间内大量不同ISR页面被访问（比如爬虫批量爬取），内存会持续上涨，直到GC触发或缓存被淘汰。

2. 是否需要考虑fetch请求的缓存？ #

• 必须重视fetch请求的缓存优化。如果每个页面的fetch请求未启用缓存，爬虫批量访问时会重复发起大量请求，不仅增加后端负载，还会导致内存中堆积大量未释放的请求响应数据、Promise实例等，加剧内存占用。
• 可通过以下方式优化：
  • 在fetch中添加next: { revalidate: 你的ISR刷新时间 }或cache: 'force-cache'，让Next.js缓存请求结果
  • 后端接口配置HTTP缓存头Cache-Control，开启响应缓存
  • 页面组件中避免存储未使用的请求数据，及时释放无用变量

3. 是否需要升级实例类型？例如如何判断t3.large是否足够？ #

• 优先尝试前面的优化手段，若内存占用仍持续高位且频繁触发OOM，再考虑升级实例。t3.large拥有8GiB内存，比t3.medium翻倍，能有效缓解内存压力，但并非根本解决方案。
• 判断t3.large是否足够的方法：
  • 开启内存监控（如AWS CloudWatch或容器内监控工具），记录优化后的内存峰值与平均占用
  • 模拟爬虫批量访问场景，观察内存变化：若峰值稳定在实例内存的70%以下，说明足够；若仍接近内存上限，需继续优化或考虑进一步升级

4. 是否存在上述提及之外的其他问题？ #

• ISR内存缓存无限制：Next.js默认的ISR内存缓存没有明确大小限制，大量不同页面访问后缓存可能持续膨胀。可尝试通过experimental.isrMemoryCacheSize（Next.js 13+）配置限制内存缓存条目数
• Docker资源未限制：若未给Docker容器设置内存上限，容器可能占用实例全部内存，导致系统OOM killer直接终止进程。启动容器时可添加--memory=3g参数，预留1GiB内存给系统及其他进程
• Next.js版本bug：v14.2.7可能存在ISR相关的内存泄漏bug，建议查看官方更新日志，升级至最新稳定版测试
• 静态资源未优化：页面包含大量未优化的静态资源（如高清大图）时，渲染过程中会在内存中处理这些资源，导致内存占用过高

关于max-old-space-size的设置 #

• 无需设置--max-old-space-size=8192，实例仅4GiB内存，设置超过可用内存的值毫无意义，反而可能导致系统内存耗尽。
• 若要设置，需添加在next start命令之前，例如：

  NODE_OPTIONS="--max-old-space-size=3072" next start
  

  这里设置为3072MiB（3GiB），预留1GiB内存给系统及其他进程，避免容器占用全部内存。

内容的提问来源于stack exchange，提问作者marcelo