非Spring项目集成FlyWay报错：无法确定schema历史表默认schema

问题场景 #

在非Spring应用中集成Flyway，启动时执行Config类初始化数据源并触发迁移，但调用migrate()时抛出异常：

org.flywaydb.core.api.FlywayException: Unable to determine schema for the schema history table. Set a default schema for the connection or specify one using the defaultSchema property!

相关代码 #

Config类：

@Singleton
@Startup
@TransactionManagement(value = TransactionManagementType.BEAN)
public class Config {
    private static final String MIGRATIONS_PATH = "migration";
    private final static Dotenv ENV = Dotenv.configure().load();
    @Resource
    private static MariaDbDataSource dataSource;

    static {
        dataSource = new MariaDbDataSource();
        try {
            dataSource.setUrl(ENV.get(FlyWayParameters.URL.getParameter()));
            dataSource.setDatabaseName(ENV.get(FlyWayParameters.SCHEMA.getParameter()));
            dataSource.setUser(ENV.get(FlyWayParameters.USER.getParameter()));
            dataSource.setPassword(ENV.get(FlyWayParameters.PASSWORD.getParameter()));
        } catch (SQLException e) {
            log.error("[ERROR] Database initialization failed. Possible problem with configuration");
        }
    }

    @PostConstruct
    private void onStartup() {
        Flyway flyway = configureFlyWay();
        flyway.migrate();
    }

    private Flyway configureFlyWay() {
        Flyway flyway = Flyway.configure()
                .dataSource(dataSource)
                .locations(MIGRATIONS_PATH)
                .load();
        return flyway;
    }
}

.env配置：

FLYWAY_URL=jdbc:mysql://localhost
FLYWAY_USER=test
FLYWAY_PASSWORD=test
FLYWAY_SCHEMA=testschema

问题原因 #

1. JDBC URL未指定默认schema：当前URL仅指向数据库服务器，未明确指定要使用的schema，导致连接无默认schema上下文。
2. 数据源配置未生效：MariaDbDataSource.setDatabaseName()的设置可能未被Flyway正确识别，部分数据源实现中该配置需配合URL参数才能生效。
3. defaultSchema配置可能有误：若之前尝试添加.defaultSchema()但未正确传入schema名称，或配置位置错误，也会导致Flyway无法识别。

解决方案 #

方案1：修改JDBC URL，直接指定schema #

更新.env中的FLYWAY_URL，在URL末尾添加schema名称：

FLYWAY_URL=jdbc:mysql://localhost/testschema?useSSL=false&serverTimezone=UTC

（可根据实际需求添加其他JDBC参数，如时区、SSL设置等）

方案2：正确配置Flyway的defaultSchema并开启自动创建schema #

在configureFlyWay()方法中，明确指定默认schema，并开启Flyway自动创建不存在的schema：

private Flyway configureFlyWay() {
    String targetSchema = ENV.get(FlyWayParameters.SCHEMA.getParameter());
    Flyway flyway = Flyway.configure()
            .dataSource(dataSource)
            .locations(MIGRATIONS_PATH)
            .defaultSchema(targetSchema) // 指定历史表所在的schema
            .createSchemas(true) // 自动创建不存在的目标schema
            .load();
    return flyway;
}

方案3：修正数据源配置逻辑 #

将schema信息直接整合到JDBC URL中，替代单独调用setDatabaseName()：

static {
    dataSource = new MariaDbDataSource();
    try {
        String url = ENV.get(FlyWayParameters.URL.getParameter());
        String schema = ENV.get(FlyWayParameters.SCHEMA.getParameter());
        // 拼接包含schema的URL
        String fullUrl = url + "/" + schema;
        dataSource.setUrl(fullUrl);
        dataSource.setUser(ENV.get(FlyWayParameters.USER.getParameter()));
        dataSource.setPassword(ENV.get(FlyWayParameters.PASSWORD.getParameter()));
    } catch (SQLException e) {
        log.error("[ERROR] Database initialization failed. Possible problem with configuration");
    }
}

验证步骤 #

1. 确认.env中FLYWAY_SCHEMA的值与目标schema一致；
2. 启动应用，检查Flyway是否成功创建flyway_schema_history表并执行迁移；
3. 若仍报错，查看数据库中目标schema是否已存在，可手动创建后再尝试迁移。

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