Docker环境下Node+Postgres的Sequelize异常求助

嘿，我帮你梳理下这个Sequelize+Docker的网络问题——这其实是挺常见的容器启动时序+命令执行环境的坑，咱们一步步拆解：

问题本质 #

你的矛盾点核心在于两个场景的网络环境不一样：

• 当database.js里host设为postgresdb时，API服务的CRUD能正常跑，因为此时PostgreSQL容器已经稳定运行，Docker的内置DNS能把容器名解析成对应IP；但迁移失败，大概率是因为迁移命令的执行环境不在Docker网络里（比如你直接在宿主机敲迁移命令），或者PostgreSQL容器还没完全就绪就跑了迁移。
• 移除host配置时，Sequelize默认用127.0.0.1，迁移能成是因为你在宿主机执行命令，宿主机通过端口映射能访问PostgreSQL；但API容器里的127.0.0.1指向容器自己，自然连不上PostgreSQL，所以CRUD报错。

验证你的场景 #

看你的docker-compose.yml，API容器加了depends_on依赖postgresdb，但这个配置只保证容器启动顺序，不保证PostgreSQL服务完全就绪（比如数据库初始化还没完成）。另外，如果是在宿主机直接跑npx sequelize-cli db:migrate，宿主机的DNS根本不知道postgresdb这个容器名，肯定会报getaddrinfo ENOTFOUND。

解决方案 #

方案1：在API容器内部执行迁移（推荐，最符合Docker最佳实践） #

让迁移和API服务在同一个网络环境下运行，直接用容器名访问PostgreSQL：

1. 修改docker-compose.yml里API服务的启动命令，先跑迁移再启动服务：

services:
  api:
    # ... 其他配置保持不变
    command: sh -c "yarn sequelize db:migrate && yarn dev"

2. 如果需要手动执行迁移（比如回滚），直接进入API容器内部操作：

# 执行迁移
docker exec -it api yarn sequelize db:migrate
# 回滚最近一次迁移
docker exec -it api yarn sequelize db:migrate:undo

方案2：适配宿主机执行迁移的场景 #

如果坚持要在宿主机跑迁移，需要做两个调整：

• 给database.js加环境区分，让迁移时用localhost（宿主机端口映射），运行时用postgresdb：

require('dotenv/config');
module.exports = {
  dialect: process.env.DB_DIALECT,
  // 当在宿主机执行迁移时，设置MIGRATE_FROM_HOST=true来切换host
  host: process.env.MIGRATE_FROM_HOST ? 'localhost' : process.env.POSTGRES_HOST,
  username: process.env.POSTGRES_USER,
  password: process.env.POSTGRES_PASSWORD,
  database: process.env.POSTGRES_DB,
  define: {
    timestamps: true,
    underscored: true,
    underscoredAll: true,
  },
};

执行迁移时带环境变量：

MIGRATE_FROM_HOST=true yarn sequelize db:migrate

• 给PostgreSQL容器加健康检查，确保服务完全就绪后再允许连接：
  在docker-compose.yml的postgresdb服务里添加：

services:
  postgresdb:
    # ... 其他配置不变
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U docker -d postdb"]
      interval: 5s
      timeout: 5s
      retries: 5

然后修改API服务的depends_on，等待PostgreSQL健康就绪：

services:
  api:
    # ... 其他配置不变
    depends_on:
      postgresdb:
        condition: service_healthy
      mongodb:
        condition: service_started
      redisdb:
        condition: service_started

额外检查项 #

• 确认API容器能正确读取到POSTGRES_HOST=postgresdb这个环境变量，执行docker exec api printenv POSTGRES_HOST验证一下。
• 你的Docker网络检查片段显示两个容器都在api网络里，这部分是正常的，不用额外调整。

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