如何在Amazon Elastic Beanstalk上运行Prisma Migrate Deploy？

我之前在EB上部署Prisma应用时也踩过类似的坑，你的配置思路是对的，但可能忽略了几个关键细节——比如环境变量加载、工作目录和Node路径的问题。下面是经过验证的解决步骤：

一、排查基础错误点 #

先确认几个前提条件是否满足：

• 你的项目package.json中已经安装了prisma和@prisma/client作为依赖，并且已经提交了package-lock.json/yarn.lock到代码仓库（EB默认会执行npm install，但依赖缺失会导致npx prisma找不到命令）。
• Prisma schema文件位于项目根目录下的prisma/schema.prisma（如果路径不同，需要在迁移命令中添加--schema ./your/custom/path/schema.prisma参数）。

二、修正.ebextensions配置文件 #

替换你现有的00_migration.config为以下内容，它解决了环境变量加载、Node路径和工作目录的核心问题：

container_commands:
  01_migrate:
    command: |
      # 从EB环境变量中读取DATABASE_URL（需提前在EB控制台设置该变量）
      export DATABASE_URL=$(/opt/elasticbeanstalk/bin/get-config environment -k DATABASE_URL)
      # 将EB安装的Node路径加入系统PATH，避免npx找不到命令
      export PATH=$PATH:/opt/elasticbeanstalk/node-install/current/bin
      # 执行Prisma迁移，明确指定代码解压后的临时工作目录
      npx prisma migrate deploy
    leader_only: true
    cwd: "/var/app/staging"

配置细节说明： #

• leader_only: true：确保只有环境中的主实例执行迁移，避免多实例重复执行导致数据库锁冲突。
• cwd: "/var/app/staging"：EB的container_commands默认工作目录可能不是你的代码目录，明确指定代码解压后的临时目录（部署完成后会同步到/var/app/current）。
• 用get-config命令获取环境变量：EB的环境变量在container_commands阶段不会自动加载到shell环境中，必须手动读取。

三、调试技巧（如果仍然出错） #

如果迁移还是失败，添加调试命令到配置中，帮助你定位具体问题：

container_commands:
  00_debug:
    command: |
      echo "=== Debug Info ==="
      echo "Current working directory: $(pwd)"
      echo "Node version: $(node -v)"
      echo "NPM version: $(npm -v)"
      echo "DATABASE_URL value: $(/opt/elasticbeanstalk/bin/get-config environment -k DATABASE_URL)"
      echo "Prisma directory contents:"
      ls -la /var/app/staging/prisma
    leader_only: true
  01_migrate:
    command: |
      export DATABASE_URL=$(/opt/elasticbeanstalk/bin/get-config environment -k DATABASE_URL)
      export PATH=$PATH:/opt/elasticbeanstalk/node-install/current/bin
      npx prisma migrate deploy
    leader_only: true
    cwd: "/var/app/staging"

然后登录EB控制台，进入你的环境，查看日志中的eb-activity.log文件，里面会包含调试命令的输出，帮你排查：

• 是否能正确获取到DATABASE_URL
• Node/Prisma命令是否存在
• Prisma schema文件是否在指定路径

四、额外注意事项 #

• 如果你使用Yarn而非NPM，把npx换成yarn prisma即可。
• 确保你的数据库安全组允许EB实例的IP访问（很多迁移失败是因为EB实例无法连接到数据库）。

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