Piranha CMS v11.0中的分布式缓存反序列化问题解析

在Piranha CMS从v10.4升级到v11.0版本后，部分用户在使用分布式缓存功能时遇到了一个与JSON反序列化相关的异常。本文将深入分析这个问题的根源、影响范围以及解决方案。

问题现象

当系统尝试从分布式缓存中获取别名URL列表时，会抛出以下异常：

Newtonsoft.Json.JsonSerializationException: Cannot create and populate list type System.Linq.Enumerable+SelectListIterator`2[Piranha.Models.Alias,Piranha.Services.AliasService+AliasUrlCacheEntry]

这个错误表明Newtonsoft.Json库在尝试反序列化一个LINQ查询结果时失败了，具体来说是一个SelectListIterator类型的对象。

技术背景

在Piranha CMS的AliasService中，系统会缓存网站的别名URL列表以提高性能。缓存机制会将对象序列化为JSON字符串存储，并在需要时反序列化还原。v11.0版本中更新了Newtonsoft.Json库，这个更新带来了更严格的类型处理机制。

问题根源

问题的核心在于AliasService中的以下代码片段：

aliasUrls = aliases.Select(x => new AliasUrlCacheEntry
{
    Id = x.Id,
    AliasUrl = x.AliasUrl
});

这里直接缓存了LINQ的Select操作结果，这是一个延迟执行的查询表达式，其类型为SelectListIterator。这种类型的对象不能被Newtonsoft.Json直接反序列化。

解决方案

修复方法很简单，只需要在缓存前将LINQ查询结果具体化为列表：

aliasUrls = aliases.Select(x => new AliasUrlCacheEntry
{
    Id = x.Id,
    AliasUrl = x.AliasUrl
}).ToList();

通过调用ToList()方法，我们将延迟执行的查询表达式转换为具体的List<T>对象，这种类型可以被Newtonsoft.Json正确序列化和反序列化。

影响范围

这个问题主要影响：

1. 使用分布式缓存的Piranha CMS v11.0部署环境
2. 涉及别名URL缓存的操作
3. 特别是从缓存中读取别名URL列表的场景

最佳实践

在Piranha CMS或其他.NET项目中处理缓存时，建议：

1. 总是缓存具体化的集合（如List、Array），而非LINQ查询表达式
2. 对于可能被序列化的对象，确保其类型可以被序列化库正确处理
3. 在升级序列化库版本时，特别注意其对复杂类型的处理变化

这个问题虽然修复简单，但它提醒我们在处理缓存和序列化时要特别注意类型的选择和转换，特别是在框架升级时要注意依赖库的行为变化。