在 spring data dynamodb 中处理空项目，核心策略是利用 optional 类型接收查询结果并配合 orelse() 或 orelsethrow() 进行非空校验。具体做法是在 repository 接口的方法签名中返回 optional<t></t>，当 dynamodb 中没有匹配到数据时，框架会自动返回空的 optional 对象，从而避免抛出异常或返回 null。
Repository 接口如何定义返回类型
直接回答：将 Repository 方法的返回值声明为 Optional<item></item> 即可让 Spring Data DynamoDB 自动处理空值映射。这样调用方无需手动检查 null，而是通过 Optional 的链式方法安全地获取数据。
import org.springframework.data.repository.CrudRepository;
import java.util.Optional;
public interface ItemRepository extends CrudRepository<Item, String> {
// 根据 ID 查找，若不存在则返回 Optional.empty()
Optional<Item> findById(String id);
}
上述代码展示了标准的 CRUD 操作。当调用 findById 且数据库中无此 ID 时，Spring Data DynamoDB 不会返回 null，而是返回一个空的 Optional 实例。开发者可以直接使用 item.orElse(defaultItem) 提供默认值，或使用 item.orElseThrow(() -> new RuntimeException("Not Found")) 在缺失时抛出特定异常。这种设计消除了传统的 null 指针检查，使代码更简洁。
立即学习“Java免费学习笔记（深入）”；
自定义查询方法如何处理空结果
直接回答：对于基于属性或复杂条件的自定义查询，同样应返回 Optional<t></t>。Spring Data DynamoDB 会根据查询条件扫描表，如果未找到任何匹配项，则封装为空 Optional；如果找到一项，则封装为该对象；如果找到多项，通常建议返回 List 而非 Optional，除非业务逻辑明确只取第一个。
import org.springframework.data.repository.query.Param;
import java.util.Optional;
public interface ItemRepository extends CrudRepository<Item, String> {
// 根据名称查找单个项目
Optional<Item> findByName(@Param("name") String name);
}
在自定义查询中，findByName 方法会生成对应的 DynamoDB Query 或 Scan 请求。如果表中没有名为指定值的记录，返回的 Optional 将为空。开发者在处理此类结果时，应保持与主键查询一致的风格，确保所有可能返回单条记录的查询都统一使用 Optional 包装，以保持一致的空值处理逻辑。
基于 findById 返回空 Optional 的具体处理
直接回答：当 findById 返回空 Optional 时，意味着 DynamoDB 中不存在该主键对应的项目。此时程序应进入“项目不存在”的处理分支，例如返回 HTTP 404 状态码或提供默认配置对象，而不是尝试访问内部字段导致 NullPointerException。
import org.springframework.stereotype.Service;
import java.util.Optional;
@Service
public class ItemService {
private final ItemRepository repository;
public ItemService(ItemRepository repository) {
this.repository = repository;
}
public Item getItemOrFallback(String id) {
Optional<Item> itemOpt = repository.findById(id);
if (itemOpt.isPresent()) {
return itemOpt.get();
} else {
// 处理空项目的情况：返回默认值或抛出异常
return new Item(id, "Default Name");
}
}
}
在上述服务层代码中，getItemOrFallback 方法演示了典型的空值处理流程。首先调用 repository.findById(id) 获取 Optional。接着通过 isPresent() 判断是否存在数据。如果为空，即 DynamoDB 中无该项目，则执行 else 分支，创建一个默认实例或记录日志。这种显式的分支处理确保了即使在没有数据的情况下，系统也能稳定运行，不会出现因解引用 null 而导致的崩溃。
