Flyway 5.0.7与CockroachDB 2.0兼容问题咨询

结合你的场景来看，问题大概率是配置语法错误、驱动兼容性不足或者Flyway老版本对CockroachDB支持不完善导致的，我整理了几个针对性的解决方案：

1. 先修复Gradle配置的语法错误 #

你的flyway配置块里，字符串值没有加引号，这在Groovy语法里是不合法的，会直接导致Flyway无法读取正确的连接参数。修改后的配置如下：

buildscript {
    dependencies {
        classpath "org.postgresql:postgresql:42.2.5"
    }
}
plugins {
    id "org.flywaydb.flyway" version "5.0.7"
}
description = "test-app"
flyway {
    url = "jdbc:postgresql://localhost:26257/test_dev?sslmode=disable" // 给URL添加引号
    user = "root" // 给用户名添加引号
    password = "" // 显式设为空字符串，避免解析歧义
    schemas = ["public"] // 明确指定默认schema，CockroachDB默认使用public
}

2. 升级PostgreSQL驱动版本 #

你当前使用的postgresql:42.1.4和CockroachDB 2.0的兼容性有限，CockroachDB官方推荐针对2.0版本使用42.2.x系列的PostgreSQL驱动（比如42.2.5），这个版本修复了不少和CockroachDB交互的兼容性问题，比如元数据查询、事务处理的适配逻辑。

3. 验证Docker中CockroachDB的运行状态 #

确保你的CockroachDB容器满足以下条件：

• 容器以--insecure模式启动（因为你配置了sslmode=disable，如果CockroachDB启用了SSL，会直接拒绝无加密连接）。
• 端口26257已经正确映射到主机的26257，可以用docker ps命令确认端口映射状态。
• test_dev数据库已创建：通过cockroach sql --insecure --host=localhost:26257连接后，执行CREATE DATABASE IF NOT EXISTS test_dev;确保目标数据库存在。

4. 升级Flyway版本（若以上方案无效） #

Flyway 5.0.7是2018年的老版本，对CockroachDB的正式支持还不够完善。建议升级到Flyway 5.2.4（这个版本是5.x系列中对CockroachDB支持较好的版本，且兼容Gradle），修改plugin配置为：

plugins {
    id "org.flywaydb.flyway" version "5.2.4"
}

新版本的Flyway优化了对CockroachDB分布式特性的适配，比如调整了锁表逻辑、元数据表的创建方式，避免因和PostgreSQL的特性差异导致报错。

测试验证 #

修改完成后，运行./gradlew flywayInfo命令，查看Flyway是否能正常连接到CockroachDB并读取schema信息。如果仍有报错，可以查看Gradle日志输出，定位具体的错误类型（比如连接超时、权限问题、SQL语法不兼容等）。

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