.NET 6 Minimal API返回接口时JSON缺失派生类属性问题

.NET 6 Minimal API 默认使用 System.Text.Json 作为JSON序列化组件，默认序列化规则以编译时声明的返回类型为基准，而非运行时实际的对象类型。你的仓储方法声明返回值为ICar接口，因此序列化器只会扫描该接口定义的PropA属性，即使运行时返回的是CarExample实例，也不会自动读取派生类上新增的PropB属性。

方案1：单接口局部处理（无全局侵入，.NET 6 原生支持） #

如果仅少量接口需要返回派生类属性，直接在返回结果时显式指定按运行时类型序列化即可，不需要修改全局配置，也没有版本兼容问题：

app.MapGet("/car", async ([FromServices] ICarRepository carRepository, int carId)
{
    var car = await carRepository.GetCarByIdAsync(carId);
    // 传入运行时实际类型，指定序列化器按真实对象类型扫描所有属性
    return Results.Json(car, car?.GetType());
});

这个方案改动最小，不会影响其他接口的默认序列化行为，完全适配无法提前预知具体派生类类型的场景。

方案2：全局配置序列化规则（适配多接口场景） #

如果项目中大量存在接口/抽象类返回多态实例的场景，可以通过全局配置统一处理，避免每个接口重复写逻辑：

• 若后续升级到 .NET 7 及以上版本，可直接配置JsonPolymorphismOptions实现自动识别：

using System.Text.Json.Serialization.Metadata;
using Microsoft.AspNetCore.Http.Json;

var builder = WebApplication.CreateBuilder(args);
// 其他服务配置...
builder.Services.Configure<JsonOptions>(options =>
{
    options.SerializerOptions.TypeInfoResolverChain.Insert(0, new DefaultJsonTypeInfoResolver
    {
        Modifiers =
        {
            typeInfo =>
            {
                if (!typeInfo.Type.IsInterface && !typeInfo.Type.IsAbstract) return;
                typeInfo.PolymorphismOptions = new JsonPolymorphismOptions
                {
                    UnknownDerivedTypeHandling = JsonUnknownDerivedTypeHandling.FallBackToNearestAncestor
                };
            }
        }
    });
});

• .NET 6 环境下如果需要全局生效，可以实现一个简单的多态序列化转换器，在转换器中读取对象实际类型执行序列化即可，核心逻辑和方案1一致，只是做成全局生效的配置。

• 不需要为了这个问题额外引入Newtonsoft.Json替换默认序列化器，System.Text.Json的性能表现更优，上述方案完全可以满足需求。
• 如果后续可以枚举所有可能的派生类型，使用[JsonDerivedType]特性显式声明派生类的序列化规则，性能会比运行时动态识别更高。

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