调试jQuery DataTable服务端处理返回EF实体出现ERR_CONNECTION_RESET 200错误

为什么你的try-catch没有捕获到异常、调试器走到一半就没动静 #

• 你把异常捕获写在return Json(response)这行是完全无效的。ASP.NET Core的请求处理是分阶段的：控制器方法执行完成、把JsonResult对象返回之后，此时根本还没开始做对象序列化——序列化是由后续管道阶段的内置输出格式化器异步完成的，这部分代码的执行上下文已经脱离了你控制器方法的调用栈。哪怕序列化阶段直接抛错，也根本不会被你写在控制器里的try-catch块捕获，所以你既看不到异常堆栈，调试器也不会在catch代码块中断。
• 你观察到“调试器执行到DtResult类的public IEnumerable<T> Data { get; set; }就停止推进”，本质是序列化程序开始反射遍历这个属性指向的对象图时，碰到了无法处理的结构，直接中断了响应写出过程，最终表现为浏览器收到连接被重置的报错，甚至还会显示一个状态码200的奇怪返回结果。

为什么构造的假列表正常、真实EF查询就异常 #

• 核心问题就是你返回的EF实体类上的导航属性触发了序列化循环引用。你的StudentMaster类定义了StudentType SType导航属性，对应的关联实体必然会有一个反向的ICollection<StudentMaster> Students反向导航集合；同时StudentMaster的ICollection<Exam> Exams导航属性，对应的Exam实体也必然有反向指向StudentMaster的属性，整个对象图是首尾衔接的环结构。
• 你手动构造测试数据的时候，只给Name和identifier两个基础属性赋值，所有导航属性都是null，序列化程序碰到null直接跳过，根本碰不到循环引用的环，所以功能完全正常。
• 真实EF查询的时候，因为你大概率开启了延迟加载，或者查询时主动Include了关联导航属性，所有导航属性都被填充了实际的对象值。序列化程序遍历对象图的时候就会陷入无限递归：序列化StudentMaster → 碰到SType属性 → 序列化SType对象 → 碰到SType里的Students集合 → 遍历每个Student时又碰到SType属性……一直到序列化达到最大深度限制，而这个错误因为发生在异步管道阶段，没有被正确捕获返回给前端，直接导致TCP连接被重置。

第一步：把被吞掉的隐藏异常抓出来 #

不要靠猜，先在程序管道最前面加上全局异常处理中间件（Program.cs里，位置要在所有路由映射之前），把所有管道阶段的异常都捕获下来：

app.UseExceptionHandler(errorApp =>
{
    errorApp.Run(async context =>
    {
        context.Response.StatusCode = 500;
        context.Response.ContentType = "application/json";
        var ex = context.Features.Get<Microsoft.AspNetCore.Diagnostics.IExceptionHandlerFeature>()?.Error;
        await context.Response.WriteAsJsonAsync(new {
            error = ex?.Message,
            stackTrace = ex?.StackTrace
        });
    });
});

重新请求一次接口，你就能直接看到之前被悄悄吞掉的报错，90%以上概率是检测到对象图循环引用的提示。

第二步：按优先级解决循环引用问题 #

• 最稳妥的方案：永远不要直接把EF实体类当API响应返回。定义一个专门的表格响应DTO，只把前端实际需要展示的字段映射过去，导航属性需要展示的内容（比如SType的类型名称）直接展平成DTO的基础属性，不要把整个关联对象图扔到响应里。这种方案从根源上避免循环引用，还能减少不必要的传输数据量，避免把数据库敏感字段意外暴露给前端。
• 快速兼容方案：配置JSON序列化器直接跳过循环引用，不用改现有业务代码：
  • 如果用的是.NET Core默认的System.Text.Json，在服务配置里加：

    builder.Services.AddControllers()
        .AddJsonOptions(options =>
        {
            options.JsonSerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles;
        });
    

  • 如果用的是Newtonsoft.Json，对应配置为：

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

• 定向优化方案：给不需要序列化的反向导航属性加[JsonIgnore]特性，比如StudentType类里反向关联的Students集合、Exam类里反向关联的Student属性，序列化的时候直接跳过这些属性，从对象图里打断循环链路。

补充说明：你感觉调试器没有在序列化异常处中断，是因为VS默认的异常中断规则是“仅中断用户代码未处理的异常”，而ASP.NET Core管道中的序列化异常，是框架层面的异步代码抛出的，不属于用户代码捕获范围，所以VS不会自动帮你断在异常位置，看起来就像代码走到一半直接卡死一样。

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