.NET API泛型Dto接口JSON序列化失败问题求助

我在.NET API中采用以下架构：

• 控制器依赖泛型Entity类型的Service，返回IEnumerable<Dto<T>>集合
• Service接口负责从仓储获取实体并转换为Dto
• 定义了Entity接口、泛型Dto<T>接口，以及对应的具体实现类（如SomeEntity、SomeDto）

相关代码示例：

控制器代码 #

public class SomeController {
    private readonly Service<SomeEntity> _someService;

    // 构造函数注入
    
    [HttpGet]
    public async Task<IEnumerable<Dto<SomeEntity>>> AsyncGetSomeData() {
        return await _someService.AsyncGet();
    }
}

Service接口 #

public interface Service<T> where T : Entity
{
    Task<IEnumerable<Dto<T>>?> AsyncGet();
}

实体与Dto定义 #

public interface Entity {}

public interface Dto<T> where T : Entity {}

public record SomeEntity (Guid id) : Entity;

public record SomeDto(string Id) : Dto<SomeEntity>;

当前问题 #

返回IEnumerable<Dto<SomeEntity>>时JSON序列化结果为空，原因是序列化器无法识别Dto<SomeEntity>对应的具体实现类SomeDto。修改返回签名为IEnumerable<SomeDto>并强制转换可正常序列化，但希望不修改签名和强制转换，通过配置或映射解决。

尝试过在Dto<T>接口上添加JsonDerivedType特性，但报错：

System.InvalidOperationException: Specified type 'Application.Data.Dto.CourseDto' is not a supported derived type for the polymorphic type 'Application.Data.Dto.Dto`1[Application.Data.Entity.CourseDefinitionEntity]'. Derived types must be assignable to the base type, must not be generic and cannot be abstact classes or interfaces unless 'JsonUnknownDerivedTypeHandling.FallBackToNearestAncestor' is specified.

方案1：编程式配置多态序列化（适配泛型接口） #

System.Text.Json的JsonDerivedType特性无法直接标注泛型接口，可通过编程方式为每个具体的Dto<T>闭包类型添加派生类型映射：

// 在Program.cs中配置
builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.TypeInfoResolverChain.Insert(0, new DefaultJsonTypeInfoResolver
        {
            Modifiers = {
                typeInfo =>
                {
                    // 检测当前类型是否为Dto<T>的泛型实例
                    if (typeInfo.Type.IsGenericType && typeInfo.Type.GetGenericTypeDefinition() == typeof(Dto<>))
                    {
                        var entityType = typeInfo.Type.GetGenericArguments()[0];
                        // 根据实体类型匹配对应的具体Dto实现
                        var dtoImplType = entityType switch
                        {
                            Type t when t == typeof(SomeEntity) => typeof(SomeDto),
                            Type t when t == typeof(CourseDefinitionEntity) => typeof(CourseDefinitionDto),
                            // 新增实体时在此添加对应映射
                            _ => null
                        };

                        if (dtoImplType != null)
                        {
                            typeInfo.PolymorphismOptions ??= new JsonPolymorphismOptions();
                            typeInfo.PolymorphismOptions.DerivedTypes.Add(
                                new JsonDerivedType(dtoImplType, dtoImplType.Name)
                            );
                            // 可选：设置忽略鉴别器字段（如果不需要在JSON中显示）
                            // typeInfo.PolymorphismOptions.IgnoreUnrecognizedDiscriminators = true;
                        }
                    }
                }
            }
        });
    });

方案2：将泛型接口改为抽象类 #

把Dto<T>从接口改为泛型抽象类，即可直接使用JsonDerivedType特性标注派生类型：

// 修改Dto定义为抽象类
[JsonDerivedType(typeof(SomeDto), nameof(SomeDto))]
[JsonDerivedType(typeof(CourseDefinitionDto), nameof(CourseDefinitionDto))]
public abstract class Dto<T> where T : Entity { }

// 具体Dto实现保持不变
public record SomeDto(string Id) : Dto<SomeEntity>;
public record CourseDefinitionDto(/* 自定义属性 */) : Dto<CourseDefinitionEntity>;

此方案无需修改控制器和Service的返回签名，System.Text.Json可直接识别抽象类的派生类型并正常序列化。

方案3：自定义JsonConverter #

为每个Dto<T>的闭包类型编写自定义转换器，序列化时直接使用实例的实际类型：

// 泛型转换器实现
public class DtoConverter<T> : JsonConverter<Dto<T>> where T : Entity
{
    public override Dto<T> Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
    {
        // 若需支持反序列化，在此添加对应逻辑
        throw new NotImplementedException("反序列化未实现");
    }

    public override void Write(Utf8JsonWriter writer, Dto<T> value, JsonSerializerOptions options)
    {
        // 序列化实例的实际类型（而非抽象接口）
        JsonSerializer.Serialize(writer, value, value.GetType(), options);
    }
}

// 在Program.cs中注册转换器
builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.Converters.Add(new DtoConverter<SomeEntity>());
        options.JsonSerializerOptions.Converters.Add(new DtoConverter<CourseDefinitionEntity>());
        // 新增实体时添加对应转换器
    });

此方案直接绕过接口类型的序列化限制，强制使用具体实现类的序列化逻辑。

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