本地正常的NestJS+Prisma服务在Elastic Beanstalk启动失败求助

1. 确保Prisma客户端在部署阶段生成 #

Elastic Beanstalk部署时若未执行prisma generate，会导致@prisma/client的类型定义和核心代码缺失，直接引发类型错误。

• 检查项目package.json的scripts，添加postinstall脚本：

  "scripts": {
    "postinstall": "prisma generate"
  }
  

  该脚本会在npm install后自动生成Prisma客户端，确保部署环境能获取到所需的类型与运行代码。

2. 对齐本地与部署环境的Node.js版本 #

Node版本不匹配可能导致依赖安装或Prisma生成流程异常。

• 本地执行node -v获取当前版本，在Elastic Beanstalk控制台的环境配置中设置相同版本；也可在项目根目录添加.nvmrc文件指定版本（如v18.17.0），EB会自动读取并适配。

3. 调整部署时的依赖安装逻辑 #

若EB默认执行npm install --production，prisma作为开发依赖不会被安装，导致prisma generate无法运行。

• 在项目根目录创建.ebextensions/01_prisma_config.config文件，添加以下配置：

  container_commands:
    01_install_dev_deps:
      command: "npm install --include=dev"
    02_generate_prisma:
      command: "npx prisma generate"
    03_cleanup_dev_deps:
      command: "npm prune --production"
  

  该配置会先安装所有依赖生成Prisma客户端，再清理开发依赖，兼顾生产环境的轻量化。

4. 验证PrismaService的实现正确性 #

本地正常但部署报错，可能是TS编译后PrismaService未正确关联PrismaClient。

• 检查PrismaService代码，确保正确继承并实例化PrismaClient：

  import { Injectable, OnModuleInit, OnModuleDestroy } from '@nestjs/common';
  import { PrismaClient } from '@prisma/client';
  
  @Injectable()
  export class PrismaService extends PrismaClient implements OnModuleInit, OnModuleDestroy {
    async onModuleInit() {
      await this.$connect();
    }
  
    async onModuleDestroy() {
      await this.$disconnect();
    }
  }
  

  确认导入路径无误，避免误导入本地prisma文件夹而非@prisma/client包。

5. 确保部署时完成TS编译 #

若EB未执行TS编译直接运行源码，会触发类型检查错误。

• 检查package.json的启动脚本，确保指向编译后的JS文件：

  "scripts": {
    "build": "nest build",
    "start:prod": "node dist/main"
  }
  

• 在.ebextensions配置中添加编译命令：

  container_commands:
    01_build_project:
      command: "npm run build"
  

6. 确认.npmrc配置生效 #

检查EB部署日志，确认.npmrc文件被正确读取，unsafe-perm=true配置已生效；也可登录EB实例，直接查看项目根目录的.npmrc内容是否正确。

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