Spring Data JDBC自定义查询如何使用自定义类型参数？

首先直接给结论：你当前的@Query写法存在问题，但完全可以通过调整@Query或者Spring Data JDBC原生特性实现需求，不需要直接用UUID参数，也不一定需要依赖MyBatis。下面一步步拆解解决方案：

为什么你的当前代码不工作？ #

Spring Data JDBC和JPA的@Query逻辑有本质区别——它默认执行的是原生SQL，而非JPA风格的实体查询语句。你写的select o from Order o where o.reference = :reference会被直接发给Postgres，数据库根本不知道Order这个实体类，只认识你实际的表名（比如大概率是orders），也无法识别实体属性o.reference对应的数据库字段。

方案1：修正@Query为原生SQL #

把查询语句改成对应数据库的原生SQL，同时利用你已经注册的自定义转换器处理参数转换：

public interface OrderRepository implements CrudRepository<Order, Long> {
    @Query(value = "SELECT * FROM orders o WHERE o.reference = :reference", nativeQuery = true)
    Optional<Order> findByReference(@Param("reference") Order.Reference reference);
}

因为你已经注册了Reference与UUID的双向转换器，Spring Data JDBC会自动把Order.Reference参数转换成UUID绑定到SQL中；查询结果返回时，也会把数据库的UUID转回Order.Reference。只要你的转换器是正确注册的（比如用@Converter注解，或者在Spring配置类中添加到转换服务），这个方案就能正常工作。

方案2：更简洁的方法名推导 #

其实Spring Data JDBC支持通过方法名自动生成查询，完全不用写@Query，这是最省心的方式：

public interface OrderRepository implements CrudRepository<Order, Long> {
    Optional<Order> findByReference(Order.Reference reference);
}

只要方法名符合findBy+属性名的规则，Spring Data JDBC会自动解析生成对应的SQL查询，同时利用你注册的转换器处理参数和结果的类型转换。这是优先尝试的方案，代码最简洁，也符合Spring Data的设计理念。

方案3：自定义Repository实现（完全可控） #

如果上面两种方式都遇到问题（比如特殊的转换逻辑需求），可以通过自定义Repository实现来完全控制查询过程：

1. 先定义一个自定义接口：

public interface OrderRepositoryCustom {
    Optional<Order> findByReference(Order.Reference reference);
}

2. 实现这个接口，用JdbcTemplate手动执行查询：

public class OrderRepositoryImpl implements OrderRepositoryCustom {
    private final JdbcTemplate jdbcTemplate;
    private final Converter<Order.Reference, UUID> referenceToUuidConverter;
    private final RowMapper<Order> orderRowMapper;

    // 构造函数注入依赖
    public OrderRepositoryImpl(JdbcTemplate jdbcTemplate, 
                               Converter<Order.Reference, UUID> referenceToUuidConverter,
                               RowMapper<Order> orderRowMapper) {
        this.jdbcTemplate = jdbcTemplate;
        this.referenceToUuidConverter = referenceToUuidConverter;
        this.orderRowMapper = orderRowMapper;
    }

    @Override
    public Optional<Order> findByReference(Order.Reference reference) {
        UUID uuid = referenceToUuidConverter.convert(reference);
        String sql = "SELECT * FROM orders WHERE reference = ?";
        return jdbcTemplate.query(sql, new Object[]{uuid}, orderRowMapper)
                .stream()
                .findFirst();
    }
}

3. 让主Repository接口继承自定义接口：

public interface OrderRepository extends CrudRepository<Order, Long>, OrderRepositoryCustom {
}

这种方式完全由你掌控SQL执行和类型转换，适合复杂场景。

方案4：结合MyBatis（你提到的备选） #

如果你的项目已经在用MyBatis，或者需要更灵活的SQL控制，可以整合Spring Data JDBC和MyBatis。你可以定义MyBatis的Mapper接口，写对应的SQL映射，然后让Spring Data Repository调用这些Mapper方法。不过这会增加项目的复杂度，适合本身就依赖MyBatis的场景。

总结 #

优先尝试方案2（方法名推导），它最简洁也最符合Spring Data的使用方式；如果不行再试方案1的原生SQL@Query；特殊场景下用方案3的自定义实现；MyBatis作为最后备选即可。

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