.NET Core API返回带列表的复杂对象时遇连接重置错误求助

我之前也碰到过一模一样的情况：返回扁平实体完全正常，一用Include加载关联列表就触发net::ERR_CONNECTION_RESET，核心原因几乎都是EF实体的循环引用导致JSON序列化失败——后端生成响应时抛出异常，直接中断了和前端的连接。下面结合你提到的文件给出具体解决方案：

一、最推荐的方案：用DTO（数据传输对象）分离数据库模型与前端数据模型 #

EF实体类（比如Document.cs、Page.cs）通常包含导航属性的反向引用（比如Page里可能有public Document Document { get; set; }），直接返回实体的话，JSON序列化会陷入无限循环，后端崩溃后自然就断了连接。DTO只保留前端需要的字段，能彻底规避这个问题。

1. 创建DTO类 #

新建两个DTO文件（比如DocumentDto.cs和PageDto.cs）：

// DocumentDto.cs
public class DocumentDto
{
    public int Id { get; set; }
    public string Title { get; set; } // 替换成你Document实体里的实际字段
    // 其他前端需要的Document字段...
    public List<PageDto> Pages { get; set; } = new List<PageDto>();
}

// PageDto.cs
public class PageDto
{
    public int Id { get; set; }
    public int PageNumber { get; set; } // 替换成你Page实体里的实际字段
    // 其他前端需要的Page字段...
    // 注意：不要包含Document导航属性，除非前端必须要，那就要额外处理循环引用
}

2. 修改DocumentsController.cs，映射实体到DTO #

把原来直接返回EF实体的代码改成返回DTO：

[HttpGet]
public async Task<IActionResult> GetDocuments()
{
    // 用Include加载关联的Pages
    var documents = await _context.Documents
        .Include(d => d.Pages)
        .ToListAsync();

    // 映射实体到DTO
    var documentDtos = documents.Select(doc => new DocumentDto
    {
        Id = doc.Id,
        Title = doc.Title,
        Pages = doc.Pages.Select(page => new PageDto
        {
            Id = page.Id,
            PageNumber = page.PageNumber
        }).ToList()
    }).ToList();

    return Ok(documentDtos);
}

二、临时快速验证方案：配置JSON序列化忽略循环引用 #

如果你不想马上写DTO，可以先通过配置序列化规则绕过循环引用问题，但这个方案不推荐长期使用（实体可能包含前端不需要的字段，增加响应体积）。

.NET Core 3.0+（使用System.Text.Json） #

在Program.cs里修改服务配置：

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

.NET Core 2.x（使用Newtonsoft.Json） #

在Startup.cs里配置：

services.AddMvc()
    .AddJsonOptions(options =>
    {
        options.SerializerSettings.ReferenceLoopHandling = Newtonsoft.Json.ReferenceLoopHandling.Ignore;
    });

三、前端documents.components.ts的适配 #

确保前端接收的是DTO对应的模型，先创建TypeScript接口：

// document-dto.model.ts
export interface PageDto {
  id: number;
  pageNumber: number;
  // 其他字段...
}

export interface DocumentDto {
  id: number;
  title: string;
  pages: PageDto[];
}

然后在组件里调用接口：

import { Component, OnInit } from '@angular/core';
import { HttpClient } from '@angular/common/http';
import { DocumentDto } from './document-dto.model';

@Component({
  selector: 'app-documents',
  templateUrl: './documents.component.html'
})
export class DocumentsComponent implements OnInit {
  documents: DocumentDto[] = [];

  constructor(private http: HttpClient) {}

  ngOnInit(): void {
    this.http.get<DocumentDto[]>('/api/documents')
      .subscribe({
        next: (docs) => {
          this.documents = docs;
          console.log('加载成功：', docs);
        },
        error: (err) => {
          console.error('加载失败：', err);
        }
      });
  }
}

额外排查点 #

如果以上方案没解决问题，可以检查：

• 确认Include的导航属性名称和实体类一致，比如Document里的Pages是否正确定义为public List<Page> Pages { get; set; }
• 检查数据库中是否有大量数据导致响应体积过大，超出服务器或浏览器限制，可尝试分页返回
• 查看后端日志（比如Windows事件查看器、ASP.NET Core日志），确认序列化时是否有具体异常信息

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