第二次DbContext调用导致.NET Core 6 Web API无返回值问题

我有一个.NET Core 6 Web API接口（已简化）：

[HttpPut("{id}")]
[Consumes(MediaTypeNames.Application.Json)]
[ProducesResponseType(StatusCodes.Status200OK)]
[ProducesResponseType(StatusCodes.Status400BadRequest)]
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
public async Task<ActionResult<ArbitrationCase>> UpdateCaseAsync(int id, [FromBody] ArbitrationCase arbCase)
{
     var orig = await _context.ArbitrationCases
                        .Include(c => c.Arbitrators)
                        .Include(c => c.CPTCodes)
                        .Include(d => d.Notes)
                        .Include(d => d.OfferHistory)
                        .FirstOrDefaultAsync(d => d.Id == arbCase.Id);
     _context.Entry(orig).CurrentValues.SetValues(arbCase);
     // 取消注释下一行会导致服务无返回值
     // 会返回200 OK但响应为空
     // var payor = await _context.Payors.FindAsync(arbCase.PayorId.Value);
     await _context.SaveChangesAsync();
     return Ok(orig);
}

如代码注释所述，取消注释获取Payor的代码后，服务返回200 OK但响应内容为空。我是否违反了DbContext的某种使用限制？

编辑补充 #

1. 明确说明：Payors.FindAsync(...)方法不会报错，会返回对应值或null，return Ok(orig)始终会被执行。
2. 控制器继承自注入了_context的基类，相关代码如下：

控制器代码：

[Route("[controller]")]
[ApiController]
[Authorize]
public class CasesController : MPBaseController
{
        private readonly ILogger<CasesController> _logger;
        #region Constructor
        public CasesController(ILogger<CasesController> logger, ArbitrationDbContext context) : base(context)
        {
            _logger = logger;
        }
        #endregion

基类代码：

public class MPBaseController : ControllerBase
{
        protected readonly ArbitrationDbContext _context;
        public MPBaseController(ArbitrationDbContext context)
        {
            _context = context;
        }
}

我怀疑因ArbitrationCase类与Payors表存在外键关联，单独加载Payor记录导致EF或.NET Core出现异常，使响应流被终止/截断。希望了解如何查看响应返回客户端前的内部细节，比如是否因第二次_context调用导致orig对象序列化失败。

问题分析与解决方案 #

核心原因

问题并非违反DbContext使用限制，而是实体序列化环节出现异常：
当通过_context.Payors.FindAsync加载Payor实体后，DbContext会跟踪该实体。由于ArbitrationCase与Payor存在外键关联，DbContext会自动填充orig对象的Payor导航属性（即使你没显式Include）。如果实体类未配置循环引用处理，序列化器会陷入循环（比如Payor包含ArbitrationCase集合，ArbitrationCase又引用Payor），导致序列化失败，响应流被截断，最终返回空内容。

排查与解决方法

1. 修复序列化循环引用

   • 局部处理：在ArbitrationCase的Payor导航属性上添加[JsonIgnore]，阻止序列化该属性：

     public class ArbitrationCase
     {
         // 其他属性...
         [JsonIgnore]
         public Payor Payor { get; set; }
     }
     

   • 全局配置：在Program.cs中设置Json序列化选项，自动忽略循环引用：

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

2. 避免DbContext跟踪不必要的实体
   加载Payor时使用AsNoTracking()，不让DbContext跟踪该实体，避免自动填充orig的导航属性：

   var payor = await _context.Payors.AsNoTracking().FindAsync(arbCase.PayorId.Value);
   

3. 捕获序列化异常细节
   在控制器中手动序列化orig并记录日志，就能看到具体异常信息：

   // 在return Ok(orig)前添加
   try
   {
       var json = System.Text.Json.JsonSerializer.Serialize(orig);
       _logger.LogInformation("序列化结果：{Json}", json);
   }
   catch (Exception ex)
   {
       _logger.LogError(ex, "序列化orig对象失败");
   }
   

4. 验证DbContext生命周期
   你的DbContext是Scoped注入（默认行为），单个请求内复用完全合规，不存在使用限制问题。

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