Flyway Job执行Postgres迁移仅输出使用文档无法生效排查求助

问题根因 #

1. Kubernetes Job命令参数格式错误：你在Job的command字段中，将-connectRetries=60和migrate两个独立参数合并为同一个字符串传入，Flyway无法识别该非法参数，因此直接输出使用说明文档。
2. 镜像版本不匹配，未加载迁移脚本：你自定义的Flyway Dockerfile使用flyway/flyway:7.7.3-alpine为基础镜像，且已将SQL脚本拷贝到镜像内，但Kubernetes Job中指定的镜像为官方的flyway/flyway:6.3.1，该镜像内无你的迁移脚本，即使参数正确也无法执行迁移。
3. 可选问题：若你的SQL脚本未按照Flyway命名规范V<版本号>__<描述>.sql命名（例如V1__create_transaction_events.sql），Flyway也不会识别执行该脚本。

修复方案 #

1. 修复Kubernetes Flyway Job配置 #

修改command字段拆分参数，同时替换为你自己构建的带迁移脚本的镜像：

kind: Job
metadata:
  name: flyway-migration-job
spec:
  template:
    spec:
      containers:
      - name: flyway
        # 替换为你实际构建的Flyway镜像名，不要使用官方基础镜像
        image: 你的自定义Flyway镜像名:版本号
        # 每个参数单独作为数组的一项，不要合并
        command: ["flyway", "-url=jdbc:postgresql://postgres-master:5432/wallet", "-user=test_user", "-password=testuser1234", "-schemas=wallet", "-connectRetries=60", "migrate"]
      restartPolicy: OnFailure

如果你不想用自定义镜像，也可以将SQL脚本创建为ConfigMap，挂载到Job容器的/flyway/sql路径下。

2. 验证SQL脚本命名 #

确认你的迁移SQL文件名符合Flyway规范，必须以大写V开头，后跟版本号，双下划线分隔描述，后缀为.sql，例如V1__init_wallet_tables.sql。

3. （可选）本地Docker Compose配置修复 #

如果要在本地用Compose测试：

• 将flyway服务的depends_on从db改为postgres-db，和PostgreSQL服务名一致
• 将连接地址改为jdbc:postgresql://postgres-db:5432/wallet
• 拆分command参数格式和K8s一致

修复完成后重新应用Job即可正常执行迁移。

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