Spring JPA非唯一关联字段Join的多环境适配问题咨询

• 最初出现“关系a不存在”报错的核心原因是对@JoinFormula的语法规则误用：这个注解定义的内容会被Hibernate作为原生SQL片段直接拼接到最终查询语句中，不会对片段内的内容做JPQL语法解析、也不会自动套用实体配置的schema前缀。之前写的(select r from A r where ...)里的A是Java实体类名，不是PostgreSQL能识别的物理表名，被直接拼到SQL里后自然找不到对应的表。
• 后续硬编码schema_A的写法虽然单环境运行正常，但完全不具备多环境适配能力：一旦测试、生产环境的schema命名规则和开发环境不一致（比如测试环境schema叫test_a、生产叫prod_a），就会再次触发表找不到的SQL报错。

方案1：使用Hibernate原生schema占位符（推荐） #

Hibernate 5.2+ 内置了{h-schema}占位符能力，生成SQL时会自动替换为yml中配置的hibernate.default_schema值，从根源上避免硬编码schema路径。
调整B类中关联注解的写法即可：

@ManyToMany(fetch = FetchType.LAZY)
@NotFound(action = NotFoundAction.IGNORE)
@JoinColumnsOrFormulas({
    @JoinColumnOrFormula(formula = @JoinFormula(
        // 用{h-schema}占位符自动替换配置的默认schema，不写死路径
        value = "(select r.id from {h-schema}a r where r.reference_id = reference_id order by r.version desc limit 1)",
        referencedColumnName = "id"
    )),
    @JoinColumnOrFormula(column = @JoinColumn(
        name = "reference_id",
        referencedColumnName = "reference_id",
        insertable = false,
        updatable = false
    ))
})
private A referenceId;

适配逻辑说明：

• 不管在dev/test/prod哪个环境下，只要修改yml里的hibernate.default_schema配置，生成的SQL就会自动把{h-schema}替换为对应环境的schema名，不需要改动Java代码。
• 这个位置必须写原生SQL语法，不要把JPQL实体名塞进来，Hibernate不会对这里的内容做语法转换。

方案2：兼容低版本Hibernate的适配写法 #

如果项目使用的Hibernate版本低于5.2，不支持{h-schema}占位符，可以通过实体映射引入配置属性实现适配：

• 修改实体A的@Table注解，将schema值绑定为yml配置属性，不硬编码内容：

@Entity
@Table(name = "a", schema = "${spring.jpa.properties.hibernate.default_schema}")
public class A implements Serializable {
  // 原有字段内容保持不变
}

调整后Hibernate在解析关联SQL时，会自动从实体映射中读取配置的schema值拼接到查询语句中，同样可以实现多环境下的自动适配，不需要修改代码逻辑。

• 调整完成后可以打开show-sql: true配置，拉取一次关联数据，检查控制台打印的最终SQL：确认{h-schema}已经被完全替换为当前环境配置的schema路径，没有残留的占位符文本。
• 后续不要把schema名、表名这类和环境相关的配置硬编码在注解的SQL片段里，这类硬编码写法是多环境适配的常见坑点。

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