Spring Boot中JPA Criteria查询实现OR条件关联的问题

我正在开发Spring Boot应用，需要在JPA Criteria查询中生成带OR条件的内连接，预期SQL如下：

INNER JOIN CUSTOMER c ON t1.CUSTOMER_ID = c.CUSTOMER_ID OR t1.DEST_ID = c.CUSTOMER_ID

（t1对应SALES_ORDER表）

当前实体类SalesOrderModel中关联字段定义如下：

@OneToOne(fetch = FetchType.LAZY)
@Fetch(FetchMode.JOIN)
@JoinColumn(name = "CUSTOMER_ID", referencedColumnName = "CUSTOMER_ID", insertable = false, updatable = false)
@JoinColumn(name = "DEST_ID", referencedColumnName = "CUSTOMER_ID", insertable = false, updatable = false)
private CustomerModel customerModel;

使用Criteria API时，我写了如下代码：

Join<SalesOrderModel, CustomerModel> customerJoin = salesOrderRoot.join("customerModel", JoinType.INNER);
customerJoin.on(
        builder.or(
                builder.equal(salesOrderRoot.get("customerId"), customerJoin.get("customerId")),
                builder.equal(salesOrderRoot.get("destId"), customerJoin.get("customerId"))
        )
);

但最终生成的SQL是默认AND条件叠加自定义OR条件：

inner join customer customermo3_ on salesorder0_.customer_id=customermo3_.customer_id and salesorder0_.dest_id=customermo3_.customer_id and (salesorder0_.customer_id=customermo3_.customer_id or salesorder0_.dest_id=customermo3_.customer_id)

需要调整代码得到预期的OR连接条件。

问题核心：调用join("customerModel")时，JPA会自动应用实体类中定义的关联条件（多个@JoinColumn默认是AND逻辑），而on()方法是追加条件而非替换，导致最终SQL出现AND叠加OR的冗余逻辑。

调整方式： #

• 放弃依赖实体类中预定义的customerModel关联，直接指定要连接的CustomerModel类，手动构建完整的OR连接条件，避免JPA自动注入默认的AND关联逻辑。

修改后的Criteria代码：

// 直接关联CustomerModel类，不使用实体中预定义的关联字段
Join<SalesOrderModel, CustomerModel> customerJoin = salesOrderRoot.join(CustomerModel.class, JoinType.INNER);
customerJoin.on(
        builder.or(
                builder.equal(salesOrderRoot.get("customerId"), customerJoin.get("customerId")),
                builder.equal(salesOrderRoot.get("destId"), customerJoin.get("customerId"))
        )
);

补充建议： #

如果业务上SalesOrderModel与CustomerModel的关联确实是OR逻辑，原实体类中的customerModel字段映射不符合需求（JPA多@JoinColumn默认是AND），建议移除该字段的@OneToOne及@JoinColumn注解，避免后续查询出现不符合预期的关联逻辑。

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