Docker部署NextJS到GCP Cloud Run出现JS堆内存溢出如何解决

你遇到的是Node.js V8引擎堆内存溢出错误：Node.js运行时申请的内存超过了V8设定的堆内存上限，无法完成新的内存分配，系统发送SIGABRT信号（信号6）直接终止了进程。
本地Docker运行正常是因为本地容器默认没有严格的内存配额限制，而GCP Cloud Run默认容器内存配额仅为256MB，配额不足就会触发该错误。

快速生效方案 #

• 上调Cloud Run实例内存配额：在GCP控制台Cloud Run服务配置页，将实例内存从默认256MB调整为512MB，需求较高的场景可调整为1GB，绝大多数轻量Next.js应用调整到512MB即可正常运行。
• 显式设置Node.js堆内存上限：修改package.json中的start脚本，给node进程增加--max-old-space-size参数，参数值设置为比Cloud Run实例内存低64MB即可（预留系统运行开销），示例配置如下：

"start": "NODE_ENV=production npm run db:migrate && node --max-old-space-size=448 server.js"

架构优化方案 #

• 剥离启动流程中的数据库迁移步骤：你当前将数据库迁移放在容器启动命令中，每次实例启动都会额外启动一个Node进程执行sequelize迁移，占用额外内存。建议将迁移步骤挪到部署前的CI/CD流程（比如Cloud Build）中执行，不需要每次实例启动都跑迁移，降低启动时的内存开销。

• 开启Next.js standalone输出：在next.config.js中添加配置output: 'standalone'，Next.js构建时会自动裁剪不必要的依赖，仅保留运行必需的文件，可大幅降低运行时内存占用和镜像体积。
• 优化Docker镜像构建：使用多阶段构建，仅将运行时必需的产物、生产依赖打包到最终镜像中，剔除devDependencies和构建缓存，避免加载不必要的文件占用内存。
• 精简Next.js运行配置：关闭不需要的内置功能、第三方插件和中间件，进一步降低运行时内存开销。

注：你贴出的是docker-compose配置文件，不是镜像构建用的Dockerfile，如果需要进一步优化镜像体积，需要结合实际的Dockerfile配置做调整。

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