MacOS Catalina下Medusa.js安装10小时未完成的排查咨询

是否需要10小时？ #

完全不需要。正常情况下，Medusa的项目创建、依赖安装、编译启动全流程应在5-15分钟内完成，10小时属于异常挂起状态，需立即终止排查。

排查与解决步骤 #

1. 终止当前挂起进程 #

直接在终端按 Ctrl+C 强制终止卡住的进程，释放系统资源。

2. 修复Redis配置警告 #

虽然提示会使用模拟Redis，但这可能是启动异常的潜在诱因：

• 安装真实Redis服务（MacOS通过Homebrew）：

  brew install redis
  brew services start redis
  

• 进入项目根目录，编辑 medusa-config.js，添加/修正Redis配置：

  module.exports = {
    // 其他已有配置...
    redis_url: process.env.REDIS_URL || "redis://localhost:6379",
    // 其他已有配置...
  }
  

3. 手动分步骤启动项目 #

跳过自动启动流程，拆分前后端启动环节定位问题：

• 启动后端服务：

  cd <你的项目目录>
  npm run start
  

  正常启动会输出类似 Medusa server started on port 9000 的日志，若报错则根据提示修复（如依赖缺失、端口占用）。
• 新开终端启动管理端前端：

  cd <你的项目目录>
  npm run dev:admin
  

  编译成功后，手动访问 http://localhost:7000 即可进入管理后台，无需等待自动打开浏览器。

4. 排查Webpack编译异常 #

• 清理并重新安装依赖：

  rm -rf node_modules package-lock.json
  npm install
  

• 升级Node.js版本：MacOS Catalina自带的Node版本可能过低，Medusa要求Node.js 16.x+，升级至LTS版本（如18.x或20.x）后重新尝试。
• 检查系统资源：打开「活动监视器」，查看CPU、内存占用情况，关闭占用过高的无关进程，避免资源不足导致编译挂起。

5. 检查安装日志 #

重新执行安装并保存日志，便于定位隐藏错误：

npx create-medusa-app@latest > install.log 2>&1

安装完成后查看 install.log 文件，搜索「error」或「failed」关键词，定位具体失败环节。

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