Debian环境Docker中Go应用PostgreSQL数据库初始化问题

方案1：把迁移逻辑集成到Go应用启动流程 #

直接在Go代码里调用migrate库，让应用启动时自动执行迁移，无需手动跑命令。

首先引入migrate依赖：

go get github.com/golang-migrate/migrate/v4
go get github.com/golang-migrate/migrate/v4/database/postgres
go get github.com/golang-migrate/migrate/v4/source/file

然后在应用启动代码中添加迁移逻辑：

package main

import (
    "log"
    "os"

    "github.com/golang-migrate/migrate/v4"
    _ "github.com/golang-migrate/migrate/v4/database/postgres"
    _ "github.com/golang-migrate/migrate/v4/source/file"
)

func main() {
    // 从环境变量读取数据库连接串，适配不同环境配置
    dbURL := os.Getenv("DATABASE_URL")
    if dbURL == "" {
        // 本地调试默认值
        dbURL = "postgres://postgres:pass@localhost:5436/postgres?sslmode=disable"
    }

    // 初始化迁移工具
    m, err := migrate.New(
        "file://./schema", // 迁移文件目录路径
        dbURL,
    )
    if err != nil {
        log.Fatal("初始化迁移工具失败:", err)
    }

    // 执行迁移，ErrNoChange表示无新迁移要执行，无需报错
    if err := m.Up(); err != nil && err != migrate.ErrNoChange {
        log.Fatal("执行数据库迁移失败:", err)
    }

    // 在这里启动你的应用服务逻辑
    // ...
}

每次启动应用都会自动检查并执行未完成的迁移，完全自动化，适配持续部署场景。

方案2：在Docker镜像中打包migrate工具，启动时先执行迁移 #

修改Dockerfile，将migrate工具打包到镜像内，通过entrypoint脚本先跑迁移再启动应用。

Dockerfile示例：

# 构建Go应用
FROM golang:1.21-alpine AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN go build -o myapp .

# 下载migrate工具
FROM alpine:latest AS migrate-builder
RUN apk add --no-cache curl
RUN curl -L https://github.com/golang-migrate/migrate/releases/download/v4.15.2/migrate.linux-amd64.tar.gz | tar xz

# 最终镜像
FROM alpine:latest
WORKDIR /app
# 复制编译好的应用
COPY --from=builder /app/myapp .
# 复制migrate工具
COPY --from=migrate-builder /migrate ./migrate
# 复制迁移文件目录
COPY schema ./schema

# 编写启动脚本
COPY entrypoint.sh ./
RUN chmod +x entrypoint.sh

# 设置启动入口
ENTRYPOINT ["./entrypoint.sh"]

entrypoint.sh脚本内容：

#!/bin/sh

# 先执行数据库迁移
./migrate -path ./schema -database "$DATABASE_URL" up

# 迁移完成后启动应用
exec ./myapp

启动容器时传入数据库连接串环境变量：

docker run -e DATABASE_URL='postgres://postgres:pass@db:5432/postgres?sslmode=disable' your-image-tag

如果用docker-compose，直接在services.app.environment里配置DATABASE_URL即可。

方案3：用Docker Compose编排，单独运行migrate容器 #

适合应用与数据库分开部署的场景，在docker-compose.yml中添加migrate服务，依赖数据库，执行完迁移自动退出后再启动应用。

docker-compose.yml示例：

version: '3.8'
services:
  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: pass
      POSTGRES_DB: postgres
    volumes:
      - postgres_data:/var/lib/postgresql/data/
    ports:
      - "5432:5432"

  # 迁移服务：执行完迁移即退出
  migrate:
    image: your-app-image-tag
    command: ["./migrate", "-path", "./schema", "-database", "postgres://postgres:pass@db:5432/postgres?sslmode=disable", "up"]
    depends_on:
      - db
    restart: on-failure # 确保数据库启动成功后再执行迁移

  # 应用服务：等待迁移完成后启动
  app:
    image: your-app-image-tag
    depends_on:
      - migrate
    environment:
      DATABASE_URL: postgres://postgres:pass@db:5432/postgres?sslmode=disable
    ports:
      - "8080:8080"

volumes:
  postgres_data:

执行docker-compose up -d后，migrate服务先执行迁移，完成后退出，随后app服务启动，此时数据库表已初始化完成。

方案4：手动在服务器上执行迁移（临时方案） #

如果不想修改代码或镜像，可手动在服务器上操作：

1. 在Debian服务器安装migrate：

curl -L https://github.com/golang-migrate/migrate/releases/download/v4.15.2/migrate.linux-amd64.tar.gz | tar xz
sudo mv migrate /usr/local/bin/

2. 将本地的schema目录传到服务器：

scp -r ./schema your-server-user@your-server-ip:/opt/schema

3. 执行迁移命令（替换为服务器上的数据库连接串）：

migrate -path /opt/schema -database 'postgres://postgres:pass@localhost:5432/postgres?sslmode=disable' up

该方法仅适合临时调试，不推荐用于生产环境的自动化部署。

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