FusionCache中JsonIgnore属性失效问题的深度解析

背景介绍

在使用FusionCache这一高性能缓存库时，许多开发者会遇到一个看似奇怪的现象：当使用System.Text.Json作为序列化器时，模型类中标记了[JsonIgnore]的属性在缓存中仍然会被保留。本文将深入剖析这一现象背后的原因，并给出解决方案。

问题现象

开发者通常会定义类似如下的模型类：

public class ProvidersSport
{
    public long Id { get; set; }
    public string Name { get; set; }

    [JsonIgnore] // 期望该属性不被序列化
    public virtual Provider Provider { get; set; }
}

当使用FusionCache的System.Text.Json序列化器时，期望Provider属性不会被缓存，但实际上该属性仍然出现在缓存数据中。

根本原因

这个问题的根源在于FusionCache的多级缓存架构设计：

1. L1内存缓存：直接存储对象引用，不进行任何序列化操作
2. L2分布式缓存：需要序列化对象为字节流进行存储

[JsonIgnore]属性只在对象被序列化时生效，因此：

• 在L2缓存中，该属性会被正确忽略
• 在L1缓存中，由于不涉及序列化，原始对象（包含所有属性）会被完整保存

解决方案

方案一：启用AutoClone功能

services.AddFusionCache(options => {
    options.EnableAutoClone = true;
})
.WithSystemTextJsonSerializer(...);

AutoClone功能会在每次从缓存读取时创建对象副本，当前实现使用序列化/反序列化方式，因此会尊重[JsonIgnore]属性。

方案二：手动处理对象

// 存入缓存前手动清理不需要的属性
var cacheItem = new ProvidersSport {
    Id = original.Id,
    Name = original.Name
    // 不设置Provider属性
};
cache.Set("key", cacheItem);

方案三：使用DTO模式

// 定义专门用于缓存的DTO类
public class ProvidersSportCacheDto
{
    public long Id { get; set; }
    public string Name { get; set; }
    // 不包含Provider属性
}

性能考量

1. AutoClone方案：会带来额外的序列化/反序列化开销，但能确保缓存一致性
2. 手动处理方案：性能最优，但需要额外编码工作
3. DTO方案：结构最清晰，但需要维护额外的类

最佳实践建议

1. 对于简单场景，推荐使用AutoClone功能
2. 对于性能敏感场景，建议采用DTO模式
3. 明确区分业务模型和缓存模型的设计意图
4. 编写单元测试验证缓存行为是否符合预期

总结

FusionCache的多级缓存架构带来了性能优势，但也导致了序列化行为的差异。理解L1和L2缓存的不同工作机制，才能正确设计缓存策略。通过本文介绍的方法，开发者可以灵活控制缓存中保存的数据内容，优化应用程序的内存使用和性能表现。