FusionCache中ValueTuple序列化问题的技术解析

问题背景

在使用FusionCache进行分布式缓存时，开发者发现将ValueTuple类型的数据存入Redis后，实际存储的值变成了空对象{}。这个问题特别出现在使用System.Text.Json作为序列化器的情况下。

问题复现

当开发者尝试通过以下两种方式存储ValueTuple时：

// 方式一：直接使用ValueTuple语法
await cache.GetOrCreateAsync(
    "test",
    async _ => await Task.FromResult((42, new List<string>() { "hello", "world" }))
);

// 方式二：使用ValueTuple.Create方法
await cache.GetOrCreateAsync(
    "test2",
    async _ => await Task.FromResult(ValueTuple.Create(42, new List<string>() { "hello", "world" }))
);

Redis中存储的结果都变成了"Value": {}，而内存缓存却能正确存储这些值。

技术分析

这个问题的根源在于System.Text.Json对ValueTuple类型的序列化支持不足。具体来说：

1. 序列化链分析：

   • FusionCache使用IDistributedCache接口与Redis交互
   • IDistributedCache接口处理的是byte[]类型数据
   • 对象到byte[]的转换由配置的序列化器完成（本例中使用System.Text.Json）

2. System.Text.Json的限制：

   • System.Text.Json默认不支持ValueTuple类型的序列化
   • 这与Newtonsoft.Json不同，后者可以处理ValueTuple
   • 这是System.Text.Json设计上的一个已知限制

3. 内存缓存为何正常：

   • 内存缓存直接存储对象引用
   • 不涉及序列化/反序列化过程
   • 因此不会遇到序列化器对ValueTuple的限制

解决方案

对于需要使用ValueTuple的场景，开发者有以下几种选择：

1. 改用Newtonsoft.Json：

   • 如果项目允许，可以切换到Newtonsoft.Json作为序列化器
   • 这是最直接的解决方案

2. 自定义转换器：

   • 为ValueTuple类型编写自定义JsonConverter
   • 实现序列化和反序列化逻辑

3. 改用命名元组：

   • 使用命名元组代替ValueTuple
   • 例如：(int Number, List Words)代替(int, List)

4. 转换为DTO对象：

   • 创建专门的DTO类来替代ValueTuple
   • 这虽然增加了代码量，但提供了更好的类型安全性

最佳实践建议

1. 在分布式缓存场景中，应谨慎使用ValueTuple等特殊类型
2. 对于需要跨进程/机器传输的数据，建议使用明确的数据契约
3. 在采用新技术栈时，应充分了解其与旧组件的兼容性差异
4. 对于缓存键值对，建议进行充分的单元测试验证序列化行为

总结

FusionCache本身并不存在ValueTuple处理的问题，问题根源在于System.Text.Json序列化器的限制。理解这一层次关系有助于开发者在遇到类似问题时快速定位原因。在分布式系统开发中，序列化/反序列化行为的一致性是需要特别关注的方面，建议在项目早期就建立相应的验证机制。