如何让jOOQ在单元测试中使用测试表？

我之前在项目里也碰到过一模一样的问题——生产用PostgreSQL+jOOQ代码生成，测试用HSQLDB靠schema.sql建表，结果持久层直接引用jOOQ生成的表类时各种不兼容。下面分享几个我试过可行的方案，你可以根据项目情况选：

方案1：为测试环境单独生成jOOQ类 #

这是最彻底的类型安全方案，相当于给两套数据库环境各生成一套适配的jOOQ代码。

• 步骤：
  • 在构建脚本（Maven/Gradle）里配置两个jOOQ生成任务：一个针对生产PostgreSQL，输出到com.yourproject.jooq.prod；另一个连接测试用的HSQLDB（可以用内存模式），输出到com.yourproject.jooq.test。
  • 用Spring Profile区分环境：生产环境激活prod Profile，注入引用prod包下jOOQ类的持久层；测试环境激活test Profile，注入引用test包下类的版本。
• 示例Gradle配置片段：

jooq {
    configurations {
        prod {
            jdbc {
                driver = 'org.postgresql.Driver'
                url = 'jdbc:postgresql://localhost:5432/your_db'
                user = 'user'
                password = 'pass'
            }
            generator {
                target {
                    packageName = 'com.yourproject.jooq.prod'
                }
                database {
                    name = 'org.jooq.meta.postgres.PostgresDatabase'
                    inputSchema = 'public'
                }
            }
        }
        test {
            jdbc {
                driver = 'org.hsqldb.jdbcDriver'
                url = 'jdbc:hsqldb:mem:testdb'
                user = 'sa'
                password = ''
            }
            generator {
                target {
                    packageName = 'com.yourproject.jooq.test'
                }
                database {
                    name = 'org.jooq.meta.hsqldb.HSQLDBDatabase'
                    inputSchema = 'PUBLIC'
                }
            }
        }
    }
}

方案2：改用jOOQ动态DSL API，脱离生成类 #

如果不想维护两套生成代码，可以把直接引用生成表类的代码改成动态构建查询，这样只要表结构一致，就能适配不同数据库。

• 比如原来的代码可能是：

// 直接引用生成的类
return dslContext.select(USER.ID, USER.NAME)
                 .from(USER)
                 .where(USER.AGE.gt(18))
                 .fetch();

• 改成动态DSL的方式：

// 用动态表和字段
return dslContext.select(DSL.field("id", Long.class), DSL.field("name", String.class))
                 .from(DSL.table("user"))
                 .where(DSL.field("age", Integer.class).gt(18))
                 .fetch();

• 优点：不用管生成类的兼容问题；缺点：失去了jOOQ的类型安全，需要自己保证字段名和类型正确。

方案3：统一Schema与兼容配置，让生成类同时适配两种数据库 #

如果想只用一套生成类，需要调整jOOQ生成配置和测试环境设置，尽量抹平两个数据库的差异：

• 统一Schema名称：生产PostgreSQL用public，测试HSQLDB也要把Schema设为PUBLIC（注意HSQLDB默认是大写，jOOQ生成时可以配置忽略大小写）。
• 调整jOOQ生成器的类型映射：在生成配置里指定把PostgreSQL特有的类型（比如TEXT）映射到HSQLDB支持的类型（比如VARCHAR）。
• 配置测试环境的jOOQ方言：在src/test/resources/application.yaml里设置：

spring:
  jooq:
    sql-dialect: HSQLDB

• 生成器配置里设置generateSchemaNames=false，避免生成的表类带上特定Schema前缀，让SQL在不同环境都能找到表。

方案4：用Testcontainers替代HSQLDB，直接用真实PostgreSQL测试 #

如果项目对测试启动速度要求不是极端高，这个方案最省心——直接在测试时启动一个PostgreSQL容器，和生产环境完全一致，不用做任何适配。

• 步骤：
  • 引入Testcontainers的PostgreSQL依赖。
  • 在测试类里配置容器：

@SpringBootTest
@Testcontainers
public class UserRepositoryTest {

    @Container
    private static final PostgreSQLContainer<?> postgresContainer = new PostgreSQLContainer<>("postgres:15")
            .withDatabaseName("testdb")
            .withUsername("testuser")
            .withPassword("testpass");

    @DynamicPropertySource
    static void configureProperties(DynamicPropertyRegistry registry) {
        registry.add("spring.datasource.url", postgresContainer::getJdbcUrl);
        registry.add("spring.datasource.username", postgresContainer::getUsername);
        registry.add("spring.datasource.password", postgresContainer::getPassword);
    }

    // 测试方法直接用原来的持久层代码即可，和生产完全一致
}

• 优点：完全避免数据库兼容问题，测试结果更可信；缺点：第一次启动需要拉镜像，启动时间比HSQLDB长一点，但后续测试会快很多。

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