Spring Data JpaRepository findOne()传String参数报错求助

这个问题我之前帮很多开发者捋清楚过，本质是Spring Data JPA版本升级带来的API变更——2.x版本之后，findOne()的用法完全变了，咱们一步步来解决：

为什么会报错？ #

在Spring Data JPA 2.x及以上版本中：

• 原来用来根据ID查询实体的findOne(ID id)方法被移除了
• 现在的findOne()方法属于QueryByExampleExecutor接口，要求传入Example对象（用于「示例查询」，比如根据实体的部分属性匹配数据）
• 你直接传String类型的ID，自然会触发参数不匹配的报错

解决方案 #

1. 用findById()替代findOne()（推荐） #

这是官方推荐的替代方案，唯一需要注意的是findById()返回的是Optional<T>类型（用来优雅处理空值），示例代码如下：

// 原来的错误写法：
// User user = userRepository.findOne("user_001");

// 正确写法：
Optional<User> userOptional = userRepository.findById("user_001");

// 处理Optional的几种方式：
// 方式1：如果找不到就返回null
User user = userOptional.orElse(null);

// 方式2：如果找不到就抛出指定异常
User user = userOptional.orElseThrow(() -> new RuntimeException("用户不存在"));

// 方式3：用ifPresent处理存在的情况
userOptional.ifPresent(u -> {
    // 处理找到的用户逻辑
});

2. 自定义查询方法（如果你习惯直接返回实体） #

如果你还是想要类似旧版findOne()那样直接返回实体对象（而非Optional），可以在你的Repository接口里自定义方法：

@Repository
public interface UserRepository extends JpaRepository<User, String> {
    // 方式1：利用Spring Data的方法命名规则自动生成查询
    User findById(String id);

    // 方式2：用@Query注解自定义SQL（JPQL）
    @Query("SELECT u FROM User u WHERE u.id = :id")
    User findByUserId(@Param("id") String id);
}

调用的时候直接传String参数即可，比如userRepository.findById("user_001")，如果找不到实体，会抛出EmptyResultDataAccessException异常。

3. 如果你还在使用Spring Data JPA 1.x版本 #

如果你的项目还停留在1.x版本，那大概率是Repository接口的泛型定义有问题：

• 检查你的Repository是否正确继承JpaRepository<T, ID>，且第二个泛型参数（ID类型）和你传入的String匹配
• 比如你的实体ID是String类型，Repository应该这么定义：

  public interface UserRepository extends JpaRepository<User, String> {
      // ...
  }
  

这样findOne(String)方法就会正常生效。

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