Docker环境下Medusa Backend订阅者无法触发问题求助

一、修正Dockerfile的文件复制与依赖配置 #

Medusa订阅者默认存放在src/subscribers目录，Docker构建时若未正确复制该目录或依赖安装不全，会导致订阅者无法被加载。确保后端Dockerfile包含以下关键步骤：

FROM node:18-alpine
WORKDIR /app

# 先复制依赖文件，利用Docker缓存优化构建
COPY package*.json ./
RUN npm install

# 复制完整项目文件（含订阅者目录）
COPY . .

# TypeScript项目必须执行编译步骤
RUN npm run build

EXPOSE 9000
CMD ["npm", "run", "start"]

二、修复docker-compose.yml的错误配置 #

原配置中backend服务的volumes挂载了Postgres的数据目录，这会覆盖容器内的Medusa代码，是订阅者丢失的核心原因之一。同时添加服务健康检查，确保Redis/Postgres完全就绪后再启动后端：

services:
  postgres:
    image: postgres:10.4
    # ...其他原有配置
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      timeout: 5s
      retries: 5

  redis:
    image: redis
    # ...其他原有配置
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 3s
      timeout: 3s
      retries: 5

  backend:
    # ...其他原有配置
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_healthy
    volumes:
      # 替换为Medusa需要持久化的目录（比如上传文件目录），而非Postgres数据目录
      - ./medusa_backend/uploads:/app/uploads

三、验证EventBus初始化配置 #

确保medusa-config.js中EventBus使用默认Redis实现，且环境变量正确注入：

module.exports = {
  projectConfig: {
    redis_url: process.env.REDIS_URL,
    // ...其他配置项
  },
};

四、容器内验证订阅者存在性 #

进入后端容器检查订阅者文件是否存在，确认Docker构建未丢失文件：

docker exec -it medusa_backend sh
# TypeScript项目检查编译后的目录
ls dist/subscribers
# JS项目直接检查源码目录
ls src/subscribers

内容的提问来源于stack exchange，提问作者Frederik Bo Dahl