在spring data graphql中，处理空数据的核心做法是让repository接口返回`java.util.optional
findById查询不到记录时返回什么
当使用findById方法查询不存在的数据时，Spring Data JPA会返回一个空的Optional对象，Spring Data GraphQL将其序列化为GraphQL的null值。这意味着客户端收到的响应中该字段为null而非抛出异常或返回默认对象。开发者可以通过检查响应中的null值来判断记录是否存在，无需在业务代码中手动处理空指针。
package com.example.demo;
import org.springframework.data.jpa.repository.JpaRepository;
import java.util.Optional;
public interface UserRepository extends JpaRepository<User, Long> {
Optional<User> findById(Long id);
}
预期结果：调用findById(999L)（假设ID 999不存在）返回Optional.empty()，GraphQL查询返回{ "user": null }。
立即学习“Java免费学习笔记（深入）”；
如何区分Optional.empty()和Optional.of(null)
在Spring Data GraphQL中，Optional.empty()表示未找到实体，对应GraphQL的null；而Optional.of(null)是非法状态，会直接抛出IllegalArgumentException。实际开发中应始终确保Repository返回的是合法的Optional实例，即要么包含非空对象，要么为空。若手动构造Optional，必须使用Optional.ofNullable(value)来安全处理可能为null的值，避免直接调用of(null)导致程序崩溃。
package com.example.demo;
import org.springframework.stereotype.Service;
import java.util.Optional;
@Service
public class UserService {
private final UserRepository userRepository;
public UserService(UserRepository userRepository) {
this.userRepository = userRepository;
}
public Optional<User> findUserById(Long id) {
return userRepository.findById(id);
}
public User getSafeUser(Long id) {
return userRepository.findById(id).orElseThrow(() -> new RuntimeException("User not found"));
}
}
预期结果：findUserById(1)存在时返回Optional.of(user)，不存在时返回Optional.empty()；getSafeUser(999L)抛出RuntimeException。
当findById返回空值时GraphQL响应结构是什么
当findById返回Optional.empty()时，Spring Data GraphQL生成的响应中对应字段值为null，且该字段在Schema中必须标记为可空（即类型后带!）。例如，若User类型定义为type User { id: ID! name: String }，则查询user(id: 999) { id name }在无数据时返回{ "data": { "user": null } }。客户端需通过判断user是否为null来处理缺失数据，这是GraphQL标准行为，与后端是否使用Optional无关，但Optional确保了Java层不会因空值引发异常。
