使用缓存Cacheable报错：Cache ‘xxx‘ is configured to not allow null values but null was provided的解决方案

这个错误的原因是：你使用的缓存（名称为 xxx）被配置为不允许存储 null 值，但实际尝试存入缓存的数据是 null（通常是因为被缓存的方法返回了 null），导致缓存操作失败。

解决方法（根据实际场景选择）

方法 1：允许缓存存储 null 值（不推荐，但简单直接）

如果业务上确实需要缓存 null（例如为了避免“缓存穿透”，即频繁查询不存在的 key 导致穿透到数据库），可以在缓存配置中开启允许 null 值的选项。

以 CaffeineCacheManager 为例，修改配置：

@Bean
public CacheManager cacheManager() {
    CaffeineCacheManager cacheManager = new CaffeineCacheManager();
    // 其他配置...
    cacheManager.setAllowNullValues(true); // 允许缓存 null 值
    return cacheManager;
}

注意：允许 null 值可能导致缓存中存在大量无意义的 null 数据，建议谨慎使用。

方法 2：确保方法不返回 null（推荐，从源头避免）

修改被缓存的方法，确保其返回值不为 null。例如：

• 当查询的数据不存在时，返回一个“空对象”（如 new Goods() 而非 null）
• 或抛出特定异常（需配合全局异常处理）

示例：

@Cacheable(value = "xxx", key = "#goodsId")
public Goods getGoods(Long goodsId) {
    Goods goods = goodsMapper.selectById(goodsId);
    // 确保不返回 null：返回空对象
    return goods != null ? goods : new Goods(); // 空对象可包含默认值
}

方法 3：过滤 null 值，不缓存 null 结果（推荐，灵活控制）

使用 @Cacheable 的 unless 属性，指定“当结果为 null 时不缓存”，避免将 null 存入缓存。

示例：

// unless = "#result == null"：当方法返回值为 null 时，不执行缓存操作
@Cacheable(
    value = "xxx", 
    key = "#goodsId",
    unless = "#result == null"  // 关键配置：过滤 null 值
)
public Goods getGoods(Long goodsId) {
    // 方法可能返回 null（例如查询不到数据时）
    return goodsMapper.selectById(goodsId);
}

原理：当方法返回 null 时，unless 条件成立，Spring 会跳过缓存步骤，自然不会触发“不允许 null”的错误。

总结

• 推荐优先使用 方法 3（过滤 null） 或 方法 2（不返回 null），避免缓存无意义的 null 值，保持缓存数据的有效性。
• 仅在特殊场景（如明确需要缓存“不存在”的状态以防止缓存穿透）下，才考虑 方法 1（允许 null）。