Docker启动执行Knex migrate:latest未创建表的问题求助

1. 修复命令执行的语法与ENTRYPOINT冲突问题 #

你的docker-compose-dev.yml中command写法存在语法错误，且与Dockerfile里的ENTRYPOINT冲突：

• 原写法中，bash -c "..."执行完成后，&& "node server.js"会被当作docker-compose的命令而非容器内执行的命令，导致迁移命令执行后不会启动服务；
• Dockerfile里的ENTRYPOINT ["node", "server.js"]会将command内容作为参数传给node server.js，而非执行bash命令。

修正方案：在docker-compose中覆盖ENTRYPOINT，将完整命令放到bash -c中执行：

backend:
    # 其他配置不变
    entrypoint: ["bash", "-c"]
    command: "yarn knex --knexfile ./config/knexfile.js migrate:latest && node server.js"

2. 确保数据库服务完全就绪后再执行迁移 #

depends_on: - db仅能保证db容器启动，但无法确保数据库服务已初始化完成（比如PostgreSQL启动需要几秒时间），此时执行迁移会因连接失败而静默失败。

解决方式：

方式一：安装工具检查数据库连通性 #

在Dockerfile.dev中添加安装netcat的命令，用于检查数据库端口是否开放：

FROM node:18.15.0-alpine3.17

WORKDIR /opt/app

COPY package*.json yarn*.lock ./

RUN yarn
# 安装netcat用于检测数据库端口
RUN apk add --no-cache netcat-openbsd

COPY . .

# 移除原ENTRYPOINT，让docker-compose的command控制启动流程
# ENTRYPOINT [ "node", "server.js" ]

然后修改docker-compose的command，添加等待逻辑：

command: "until nc -z db 5432; do sleep 1; echo 'Waiting for database...'; done; yarn knex --knexfile ./config/knexfile.js migrate:latest && node server.js"

（注意将5432替换为你的数据库端口，比如MySQL是3306）

方式二：在Knex迁移命令中添加重试逻辑 #

如果不想安装额外工具，可以写一个简单的shell脚本start.sh：

#!/bin/sh
set -e

# 尝试执行迁移，失败则重试
retry_migrate() {
  echo "Running database migrations..."
  if yarn knex --knexfile ./config/knexfile.js migrate:latest; then
    echo "Migrations completed successfully"
  else
    echo "Migration failed, retrying in 2 seconds..."
    sleep 2
    retry_migrate
  fi
}

retry_migrate

# 启动服务
node server.js

将脚本放到项目根目录，修改Dockerfile.dev：

# 其他配置不变
COPY start.sh ./
RUN chmod +x start.sh
ENTRYPOINT [ "./start.sh" ]

然后docker-compose中可以去掉command配置，直接使用ENTRYPOINT的脚本。

3. 验证数据库连接配置 #

确保.env.dev中的数据库连接参数正确：

• 数据库主机名应为db（docker-compose中db服务的名称）；
• 端口、用户名、密码与db容器的配置完全一致；
• Knexfile.js正确读取了这些环境变量，没有硬编码错误的连接信息。

4. 查看容器日志排查问题 #

执行以下命令查看backend容器的日志，确认迁移命令是否执行、是否有错误输出：

docker logs backend-dev

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