Spring Data JDBC @MappedCollection适配Postgres与Oracle的问题

问题背景 #

现有基于Spring Data JDBC的Kotlin实体结构，需同时兼容PostgreSQL与Oracle数据库，通过application.properties的spring.datasource.url配置切换数据源。实体定义如下：

data class NewsCover(
    @Id val tenantId: TenantId,
    val openOnStart: Boolean,
    val cycleDelay: Int,

    @MappedCollection(idColumn = "tenant_id", keyColumn = "tenant_id")
    val sections: Set<NewsCoverSection>,
)

data class NewsCoverSection(
    @Id val id: NewsCoverSectionId,
    val title: String,
    val pinnedOnly: Boolean,
    val position: Int,
    val tenantId: TenantId,
    // 其他字段
)

interface NewsCoverRepo : CrudRepository<NewsCover, TenantId> { }

该结构在PostgreSQL中运行正常，但在Oracle中报错，生成的SQL如下：

SELECT "NEWS_COVER_SECTION"."ID" AS "ID", "NEWS_COVER_SECTION"."TITLE" AS "TITLE", "NEWS_COVER_SECTION"."POSITION" AS "POSITION", "NEWS_COVER_SECTION"."TENANT_ID" AS "TENANT_ID", "NEWS_COVER_SECTION"."PINNED_ONLY" AS "PINNED_ONLY" 
FROM "NEWS_COVER_SECTION" 
WHERE "NEWS_COVER_SECTION"."tenant_id" = ?

核心问题：@MappedCollection中指定的小写列名tenant_id在PostgreSQL中可正常匹配小写列，但Oracle中带引号的小写标识符无法匹配默认的大写列名；若改为大写TENANT_ID，则PostgreSQL无法匹配小写列。

已尝试无效方案 #

• 重写Oracle的NamingStrategy：无法覆盖@MappedCollection中显式指定的带引号标识符。
• 尝试在@MappedCollection中使用动态列名：该注解仅接受编译时常量，不支持SpEL，无法根据数据源URL动态切换列名。

可行解决方案 #

方案1：利用Spring Data JDBC的IdentifierProcessing配置（推荐） #

Spring Data JDBC 2.4及以上版本支持IdentifierProcessing，可针对不同数据库配置标识符的大小写转换与引号规则：

1. 创建配置类，根据数据源URL判断数据库类型，注册对应的IdentifierProcessing Bean：

import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration
import org.springframework.data.jdbc.core.convert.IdentifierProcessing
import org.springframework.data.jdbc.core.convert.IdentifierProcessing.LetterCasing
import org.springframework.data.jdbc.core.convert.IdentifierProcessing.Quoting

@Configuration
class JdbcIdentifierConfig {

    @Bean
    @ConditionalOnProperty(prefix = "spring.datasource", name = ["url"], havingValue = "jdbc:postgresql:", matchIfMissing = false)
    fun postgresIdentifierProcessing(): IdentifierProcessing {
        return IdentifierProcessing.create(
            LetterCasing.AS_IS,
            LetterCasing.AS_IS,
            Quoting.ALWAYS
        )
    }

    @Bean
    @ConditionalOnProperty(prefix = "spring.datasource", name = ["url"], havingValue = "jdbc:oracle:", matchIfMissing = false)
    fun oracleIdentifierProcessing(): IdentifierProcessing {
        return IdentifierProcessing.create(
            LetterCasing.UPPER_CASE,
            LetterCasing.UPPER_CASE,
            Quoting.NEVER
        )
    }
}

2. 保持@MappedCollection中的列名为小写：

@MappedCollection(idColumn = "tenant_id", keyColumn = "tenant_id")
val sections: Set<NewsCoverSection>,

效果：

• PostgreSQL下：生成带引号的小写列名"tenant_id"，匹配实际列。
• Oracle下：将列名转换为大写且不添加引号，Oracle会自动匹配默认的大写列TENANT_ID。

方案2：自定义JdbcConverter（进阶） #

若IdentifierProcessing无法满足需求，可自定义JdbcConverter，重写列名解析逻辑，根据数据源类型动态调整大小写：

1. 自定义JdbcConverter实现类，添加数据库类型判断逻辑，修改列名的大小写处理。
2. 使用@ConditionalOnProperty注解，针对不同数据源注册对应的JdbcConverter Bean。

方案3：数据库层面兼容（不推荐） #

若允许修改数据库Schema：

• PostgreSQL：将列名改为大写，或创建小写同义词。
• Oracle：创建带引号的小写列名（"tenant_id"）。
  但该方案违背“无需修改数据库Schema适配ORM”的要求，仅作为备选。

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