Spring Data JDBC中使用Criteria API关联查询时关联实体字段条件失效的问题

嗨，我完全理解你遇到的这个困扰——Spring Data JDBC（V3.3.6版本）的Criteria API在处理关联实体的查询条件时，确实存在这样的局限性，我之前做项目的时候也碰到过类似的情况。

先帮你梳理下问题本质：你定义的EntityA和EntityB的关联映射是正确的，创建、更新操作都正常，但当你尝试用Criteria API过滤关联实体EntityB的value字段时，框架生成的SQL错误地把条件绑定到了主表entity_a上，而不是关联表entity_b（别名other），这就导致了查询报错。

问题原因 #

Spring Data JDBC的Criteria API设计得比较轻量化，和JPA的Criteria API相比功能要有限很多。它目前还不能正确解析关联实体的字段路径（比如other.value或者other_value这种写法），在生成WHERE条件时，会默认将所有字段归属到主实体对应的表上，这就是为什么你看到的SQL里条件是"entity_a"."value" = ?，而不是期望的"other"."value" = ?。

可行的解决方案 #

1. 使用@Query手写自定义SQL（最推荐）

这是目前最可靠的解决方式，能完全控制查询语句的结构，完美生成你期望的SQL。你可以在EntityA对应的Repository接口里定义如下方法：

import org.springframework.data.jdbc.repository.query.Query;
import org.springframework.data.repository.CrudRepository;
import org.springframework.data.repository.query.Param;
import java.util.List;

public interface EntityARepository extends CrudRepository<EntityA, Long> {

    @Query("SELECT a.id, b.entity_a_id, b.value " +
           "FROM entity_a a " +
           "LEFT OUTER JOIN entity_b b ON b.entity_a_id = a.id " +
           "WHERE b.value = :targetValue")
    List<EntityA> findByEntityBValue(@Param("targetValue") String targetValue);
}

调用这个方法就能准确查询出EntityB的value符合条件的所有EntityA实例。

2. 直接使用JdbcTemplate执行自定义查询

如果你需要更灵活的结果映射，也可以直接用JdbcTemplate来执行查询，手动将结果映射到实体对象：

import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Repository;
import java.util.List;

@Repository
public class EntityACustomRepository {

    private final JdbcTemplate jdbcTemplate;

    public EntityACustomRepository(JdbcTemplate jdbcTemplate) {
        this.jdbcTemplate = jdbcTemplate;
    }

    public List<EntityA> findByEntityBValue(String targetValue) {
        String sql = "SELECT a.id, b.entity_a_id, b.value " +
                     "FROM entity_a a " +
                     "LEFT OUTER JOIN entity_b b ON b.entity_a_id = a.id " +
                     "WHERE b.value = ?";
        
        return jdbcTemplate.query(sql, new Object[]{targetValue}, (rs, rowNum) -> {
            EntityB entityB = new EntityB(rs.getLong("entity_a_id"), rs.getString("value"));
            return new EntityA(rs.getLong("id"), entityB);
        });
    }
}

补充说明 #

目前Spring Data JDBC的3.x版本确实不支持通过Criteria API来过滤关联实体的字段，这是它的一个已知功能限制。官方文档也明确提到，Spring Data JDBC主打轻量化的关系型数据访问，复杂的关联查询建议使用自定义SQL或者JdbcTemplate来实现，暂时没办法通过Criteria API达成你的需求。

备注：内容来源于stack exchange，提问作者beeesch