使用PutAsJsonAsync时含导航属性的Model引发400错误求助

你遇到的问题本质是EF实体的导航属性在序列化时出了问题，导致请求数据不符合API的模型验证，直接返回400，连控制器断点都没触发。下面给几个实用的解决办法：

1. 用DTO分离实体和交互模型（优先推荐） #

别直接传EF实体，专门建个GameUpdateDto，只包含需要更新的字段，完全去掉导航属性。Blazor端序列化这个DTO传给API，API接收后再映射到实体做更新。这样既避免序列化问题，也符合分层架构的设计。

示例代码：

// 新建DTO类
public class GameUpdateDto
{
    public int Id { get; set; }
    public string GameName { get; set; }
    // 只保留你需要更新的业务字段，导航属性一概不要
}

// Blazor端调用接口
var updateDto = new GameUpdateDto 
{ 
    Id = targetGame.Id, 
    GameName = targetGame.GameName 
};
var response = await httpClient.PutAsJsonAsync($"api/games/{targetGame.Id}", updateDto);

// API控制器接收DTO
[HttpPut("{id}")]
public IActionResult UpdateGame(int id, GameUpdateDto updateDto)
{
    if (id != updateDto.Id) return BadRequest();
    var game = _dbContext.Games.Find(id);
    // 把DTO的字段映射到实体
    game.GameName = updateDto.GameName;
    _dbContext.SaveChanges();
    return NoContent();
}

2. 配置序列化规则忽略导航属性 #

如果你不想建DTO，可以在API端配置JSON序列化选项，或者直接在实体的导航属性上加标记，让序列化时跳过这些属性：

方法A：在实体属性上加[JsonIgnore] #

直接给Game实体的导航属性加特性，序列化时自动忽略：

public class Game
{
    public int Id { get; set; }
    public string GameName { get; set; }

    [JsonIgnore] // 标记忽略
    public Season Season { get; set; }
    [JsonIgnore]
    public GameType GameType { get; set; }
    [JsonIgnore]
    public Venue Venue { get; set; }
}

方法B：在API全局配置序列化选项 #

在Program.cs里配置，忽略循环引用（导航属性常导致循环引用问题）：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        // 忽略循环引用
        options.JsonSerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles;
    });

3. 避免Blazor端加载EF代理对象 #

如果Blazor端的Game实体是从EF Core查出来的，可能是延迟加载的代理对象，导航属性处于未初始化状态，序列化时会触发加载逻辑导致异常。可以查询时用AsNoTracking()或者关闭延迟加载：

// 查询时禁用跟踪，避免代理对象
var game = await _dbContext.Games.AsNoTracking().FirstOrDefaultAsync(g => g.Id == gameId);

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