Orleans IPersistentState POCO命名空间重构后序列化失败求助

我通过<PackageReference Include="Microsoft.Orleans.Sdk" Version="8.2.0" />为一个record生成序列化器，代码如下：

namespace BaseNamespace.OldNameSpace;
[GenerateSerializer, Alias("MyRecord")]
public sealed record MyRecord
{
    [Id(0)]
    public string Name{ get; set; }
    [Id(1)]
    public int Age { get; set; }
}

对应的Grain构造函数：

public sealed class MyRecordGrain([PersistentState(stateName: "MyRecordValue", "MyRecordStorageKey")] IPersistentState<MyRecord> state) : IGrain, IMyRecordGrain

原本可以正常存储和读取对象，SQL Server的OrleansStorage表中PayloadBinary列的内容为：

{
    "$id": "1",
    "$type": "BaseNamespace.OldNameSpace.MyRecord, MyProject.Common.Model",
    "Name": "Anthony",
    "Age": 14
}

但将MyRecord的命名空间从BaseNamespace.OldNameSpace改为BaseNamespace.NewNameSpace后，调用Grain时出现序列化失败，报错信息：

Error from storage provider AdoNetGrainStorage.personCache during ReadStateAsync for grain personCache/PersonCacheKey

Exc level 0: Newtonsoft.Json.JsonSerializationException: Error resolving type specified in JSON 'BaseNamespace.OldNameSpace.MyRecord, MyProject.Common.Model], System.Collections.Concurrent'. Path '$type', line 1, position 263.
   at Newtonsoft.Json.Serialization.JsonSerializerInternalReader.ResolveTypeName(JsonReader reader, Type& objectType, JsonContract& contract, JsonProperty member, JsonContainerContract containerContract, JsonProperty containerMember, String qualifiedTypeName)
   at Newtonsoft.Json.Serialization.JsonSerializerInternalReader.ReadMetadataProperties(JsonReader reader, Type& objectType, JsonContract& contract, JsonProperty member, JsonContainerContract containerContract, JsonProperty containerMember, Object existingValue, Object& newValue, String& id)
   at Newtonsoft.Json.Serialization.JsonSerializerInternalReader.CreateObject(JsonReader reader, Type objectType, JsonContract contract, JsonProperty member, JsonContainerContract containerContract, JsonProperty containerMember, Object existingValue)
   at Newtonsoft.Json.Serialization.JsonSerializerInternalReader.CreateValueInternal(JsonReader reader, Type objectType, JsonContract contract, JsonProperty member, JsonContainerContract containerContract, JsonProperty containerMember, Object existingValue)
   at Newtonsoft.Json.Serialization.JsonSerializerInternalReader.Deserialize(JsonReader reader, Type objectType, Boolean checkAdditionalContent)
   at Newtonsoft.Json.JsonSerializer.DeserializeInternal(JsonReader reader, Type objectType)
   at Newtonsoft.Json.JsonSerializer.Deserialize(JsonReader reader, Type objectType)

改回原命名空间后恢复正常。我有两个疑问：

1. 如何避免这种命名空间重构导致的错误？
2. 既然Grain构造函数中已指定IPersistentState<MyRecord>，序列化数据为何仍需存储程序集和命名空间信息？

一、避免命名空间重构错误的方案 #

1. 配置JSON序列化类型映射 #

从报错信息能判断你用的是Newtonsoft.Json作为序列化器，可通过自定义ISerializationBinder添加类型重定向规则，让序列化器把旧命名空间的类型映射到新类型：

public class CustomSerializationBinder : ISerializationBinder
{
    public Type BindToType(string assemblyName, string typeName)
    {
        // 匹配旧类型，替换为新命名空间的目标类型
        if (typeName == "BaseNamespace.OldNameSpace.MyRecord")
        {
            return typeof(BaseNamespace.NewNameSpace.MyRecord);
        }
        // 其他类型保持默认处理逻辑
        return Type.GetType($"{typeName}, {assemblyName}");
    }

    public void BindToName(Type serializedType, out string assemblyName, out string typeName)
    {
        // 序列化时统一输出新类型的标识
        if (serializedType == typeof(BaseNamespace.NewNameSpace.MyRecord))
        {
            assemblyName = "MyProject.Common.Model";
            typeName = "BaseNamespace.NewNameSpace.MyRecord";
        }
        else
        {
            assemblyName = serializedType.Assembly.FullName;
            typeName = serializedType.FullName;
        }
    }
}

然后在Orleans的AdoNet存储配置中注入这个自定义Binder：

services.AddOrleans(builder =>
{
    builder.AddAdoNetGrainStorage("MyRecordStorageKey", options =>
    {
        options.ConnectionString = "你的数据库连接字符串";
        options.JsonSerializerSettings = new JsonSerializerSettings
        {
            TypeNameHandling = TypeNameHandling.Auto,
            SerializationBinder = new CustomSerializationBinder()
        };
    });
});

2. 切换到Orleans原生序列化 #

你已经给MyRecord加了[Alias("MyRecord")]特性，但默认的JSON序列化不会自动识别这个别名。如果切换到Orleans原生二进制序列化，会自动使用别名标识类型，命名空间变更不会影响反序列化：

builder.AddAdoNetGrainStorage("MyRecordStorageKey", options =>
{
    options.ConnectionString = "你的数据库连接字符串";
    options.UseJsonSerialization = false; // 禁用JSON，启用原生二进制序列化
});

这种方式下存储的是二进制数据，而非JSON，且依赖你定义的别名做类型匹配，重构命名空间后无需额外修改。

3. 批量迁移旧数据 #

如果数据库中已有大量旧数据，可执行SQL脚本批量替换PayloadBinary中的旧类型标识：

UPDATE OrleansStorage
SET PayloadBinary = REPLACE(CAST(PayloadBinary AS VARCHAR(MAX)), 'BaseNamespace.OldNameSpace.MyRecord', 'BaseNamespace.NewNameSpace.MyRecord')
WHERE PayloadBinary LIKE '%BaseNamespace.OldNameSpace.MyRecord%'

注意：执行前务必备份数据，只针对确认包含旧类型的记录操作。

二、为什么序列化数据需要存储类型信息？ #

虽然IPersistentState<MyRecord>指定了泛型类型，但Orleans的AdoNet存储提供者是通用存储实现——它要处理任意Grain的任意类型状态数据，同一个存储表中会混杂多种类型的状态。

设计上，通用存储组件不会依赖调用方的泛型类型信息反序列化：一是因为存储层无法在分布式环境下可靠获取调用方的泛型参数；二是同一个存储提供者可能被多个不同类型的Grain共享，必须通过存储的类型标识来准确匹配反序列化目标类型。

另外，Newtonsoft.Json的TypeNameHandling.Auto模式会在序列化复杂类型时自动写入$type字段，这也是你在JSON中看到该字段的原因，即使是明确的泛型类型，通用存储依然依赖这个标识完成反序列化。

内容的提问来源于stack exchange，提问作者Fernando