.NET Core 3返回EF生成Table对象时Content-Type异常致500错误

这个问题的核心原因是EF生成的实体类包含导航属性（virtual关联），JSON序列化时遇到了循环引用或者无法处理的延迟加载代理对象，导致序列化失败，ASP.NET Core在捕获到未处理的序列化异常后，会默认返回text/plain类型的500错误；而你自定义的LoginModelDto没有这些关联属性，所以能正常序列化为application/json并返回200 OK。

下面是具体的解决思路和方案：

1. 配置JSON序列化忽略循环引用 #

如果你的项目使用.NET Core 3.0+的System.Text.Json，可以在Program.cs（或旧版本的Startup.cs）中配置序列化选项，忽略循环引用：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        // 忽略循环引用
        options.JsonSerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles;
        // 可选：如果需要序列化null值，可以添加这行
        options.JsonSerializerOptions.DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull;
    });

如果你的项目使用Newtonsoft.Json（比如.NET Core 2.x或手动配置），则配置如下：

builder.Services.AddControllers()
    .AddNewtonsoftJson(options =>
    {
        options.SerializerSettings.ReferenceLoopHandling = ReferenceLoopHandling.Ignore;
    });

2. 禁用延迟加载代理或避免序列化代理对象 #

EF默认会为带有virtual导航属性的实体生成延迟加载代理对象，这些代理对象在序列化时容易出问题。你可以：

方法A：全局禁用延迟加载 #

在你的DbContext的OnConfiguring方法中关闭延迟加载：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.UseLazyLoadingProxies(false);
    // 其他DbContext配置...
}

方法B：查询时显式关闭代理跟踪 #

在查询数据时使用AsNoTracking()，避免生成代理对象：

var res = _tableService.getData(data).AsNoTracking().ToList();

同时，如果你需要加载关联数据，建议用Include/ThenInclude提前加载，避免延迟加载触发的序列化问题：

var res = _tableService.getData(data)
    .Include(t => t.objname) // 加载关联的Obj对象
    .AsNoTracking()
    .ToList();

3. 最佳实践：使用DTO（数据传输对象）返回数据 #

直接返回EF实体不仅会遇到序列化问题，还可能暴露不必要的字段、增加数据传输量，甚至带来安全风险。最好的方式是像你使用LoginModelDto那样，创建专门的DTO类，只包含需要返回给前端的字段，然后将EF实体映射到DTO：

// 定义TableDto
public class TableDto
{
    public int Id { get; set; }
    public int Field1 { get; set; }
    public int Field2 { get; set; }
    public bool IsActive { get; set; }
    public DateTime CreatedTime { get; set; }
    // 只保留需要返回的字段，去掉不必要的导航属性
}

// 在控制器中映射并返回
var res = _tableService.getData(data)
    .Select(t => new TableDto
    {
        Id = t.Id,
        Field1 = t.Field1,
        Field2 = t.Field2,
        IsActive = t.IsActive,
        CreatedTime = t.CreatedTime
    })
    .ToList();
return Ok(res);

你也可以使用AutoMapper这类工具来简化实体到DTO的映射，减少重复代码。

内容的提问来源于stack exchange，提问作者Paulius Papaurėlis