MedusaJS本地安装失败：npx medusa db:migrate执行出错

问题分析 #

核心问题是环境变量占位符$DB_NAME未被正确替换为实际数据库名，导致Medusa尝试连接名为$DB_NAME的不存在数据库；同时自动创建数据库的流程未完成，后续迁移命令无法执行。

解决步骤 #

• 检查并修正.env文件配置
  进入项目根目录market2，打开.env文件，确认DATABASE_URL格式正确：

  DATABASE_URL=postgres://postgres:xxxxxx@localhost:5432/postgres
  

  • 替换xxxxxx为你设置的Postgres密码
  • 确认数据库名postgres与你初始化时指定的一致，且Postgres服务已启动

• 手动创建目标数据库（如果需要）
  若Postgres中不存在指定的数据库，用命令行工具创建：

  # 登录Postgres
  psql -U postgres
  
  # 创建数据库（如果不存在）
  CREATE DATABASE postgres;
  
  # 退出
  \q
  

• 手动执行数据库迁移
  在项目根目录下执行迁移命令：

  npx medusa db:migrate
  

  若仍提示环境变量问题，可显式指定变量运行：

  DATABASE_URL=postgres://postgres:xxxxxx@localhost:5432/postgres npx medusa db:migrate
  

• 验证Redis配置（可选）
  日志提示redisUrl not found，虽可用fake redis临时运行，但生产环境建议安装Redis后在.env中添加：

  REDIS_URL=redis://localhost:6379
  

额外排查点 #

• 用pg_isready -U postgres确认Postgres服务正在运行
• 确保Postgres用户postgres具备创建数据库和表的权限
• 若残留旧配置导致问题，可删除项目目录后重新执行npx create-medusa-app@latest，确保初始化时准确输入数据库信息

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