如何在JPA Repository的findBy查询未找到时返回指定值？

方案一：返回默认User对象 #

保持Repository层的Optional返回逻辑不变，在Resource层通过Optional.orElseGet()生成预设的默认值：

Repository层代码

Optional<User> findByUsernameAndStatusFalse(String username);

Resource层改造代码

@GetMapping("/user/username/{username}")
public ResponseEntity<User> getUser(@PathVariable String username) {
    Optional<User> user = userRepository.findByUsernameAndStatusFalse(username);
    // 无匹配数据时返回预设的默认用户对象
    User targetUser = user.orElseGet(() -> {
        User defaultUser = new User();
        defaultUser.setUsername("anonymous");
        defaultUser.setStatus(false);
        // 根据业务需求补充其他字段配置
        return defaultUser;
    });
    return ResponseEntity.ok(targetUser);
}

方案二：返回自定义响应内容 #

如果不需要返回User类型，而是更灵活的自定义提示或响应结构，可以调整返回类型并显式判断空值：

Resource层改造代码

@GetMapping("/user/username/{username}")
public ResponseEntity<Object> getUser(@PathVariable String username) {
    Optional<User> user = userRepository.findByUsernameAndStatusFalse(username);
    if (user.isPresent()) {
        return ResponseEntity.ok(user.get());
    } else {
        // 返回指定的自定义响应体
        return ResponseEntity.ok(Map.of(
            "code", "USER_NOT_FOUND",
            "message", "未找到状态为禁用的指定用户",
            "data", null
        ));
    }
}

核心思路 #

• Optional.orElseGet()采用懒加载逻辑，仅在Optional为空时才执行默认对象的创建，避免不必要的资源消耗
• 若需自定义非User类型的响应，直接通过isPresent()判断空值，返回符合业务需求的响应结构即可

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