.NET 6 WebAPI异步REST端点多态返回类型丢失问题求助

问题原因 #

同步方法返回Base类型时，ASP.NET Core会自动识别返回值的实际运行时类型（Derived）并按该类型序列化；但异步方法返回Task<Base>时，框架默认会以泛型参数Base的类型信息进行序列化，因此只会保留Base的属性。

可行解决方案 #

1. 配置Json序列化器支持多态 #

在Program.cs中配置JsonSerializerOptions，显式声明Base的派生类型，让序列化器能识别并序列化派生类的属性：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.TypeInfoResolverChain.Insert(0, 
            JsonSerializerOptions.Default.TypeInfoResolver);
        
        // 注册多态映射
        var baseTypeInfo = options.JsonSerializerOptions.GetTypeInfo(typeof(Base)) as JsonTypeInfo<Base>;
        baseTypeInfo.PolymorphismOptions = new JsonPolymorphismOptions
        {
            DerivedTypes =
            {
                new JsonDerivedType(typeof(Derived), nameof(Derived))
            }
        };
    });

配置后，不管同步还是异步返回Base/Task<Base>，都会正确序列化Derived的所有属性。

2. 异步方法返回Task<object> #

直接将异步方法的返回类型改为Task<object>，这样序列化器会使用返回值的实际运行时类型进行序列化：

public static async Task<object> Boo()
{
    await Task.Delay(1);
    return new Derived(10, 20);
}

这种方式无需额外配置，适合快速解决单个端点的问题，但缺点是失去了强类型的编译检查。

3. 使用JsonResult包装返回值 #

不管同步还是异步，都返回JsonResult，直接传入派生类实例，让框架按实际类型序列化：

public static async Task<IResult> Boo()
{
    await Task.Delay(1);
    return Results.Json(new Derived(10, 20));
}

这种方式灵活性高，还可以针对单个端点配置序列化选项，同时保留强类型特性。

不推荐的方案说明 #

你提到的用GetAwaiter().GetResult()将异步转同步的方式，在ASP.NET Core环境中存在死锁风险（因为会阻塞线程池线程），而且违背了异步编程的设计初衷，不建议在生产环境使用。

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