使用React调用.NET Core 3.1 EF控制器POST接口时遇空引用异常

这个错误本质上是你传给EF Core Add() 方法的实体对象是null，结合你的场景（提交包含两个子模型的表单），我帮你梳理几个最可能的遗漏点和修复方案：

1. 控制器没正确接收请求体数据 #

首先检查你的POST控制器方法是否添加了[FromBody]特性——如果没有，.NET Core无法将前端发送的JSON数据绑定到CreateGame模型上，导致model本身或其StarSystem/Ship子属性为null：

// 错误示例：缺少[FromBody]
[HttpPost]
public async Task<IActionResult> Create(CreateGame model)

// 正确写法
[HttpPost]
public async Task<IActionResult> Create([FromBody] CreateGame model)

2. 模型绑定失败（前端数据结构不匹配） #

你的CreateGame模型子属性的命名、嵌套结构必须和前端发送的JSON完全对应（默认.NET Core模型绑定大小写不敏感，但建议遵循驼峰命名约定）：

你的模型定义（示例）： #

public class CreateGame
{
    // 必须保证有getter和setter，否则无法绑定
    public StarSystem StarSystem { get; set; }
    public Ship Ship { get; set; }
}

public class StarSystem
{
    public int Id { get; set; }
    public string Name { get; set; }
}

前端/Postman需要发送的JSON结构： #

{
  "starSystem": {
    "name": "Alpha Centauri"
  },
  "ship": {
    "name": "USS Enterprise"
  }
}

如果前端发送的JSON没有嵌套starSystem/ship节点，或者键名拼写错误（比如写成starsystem），都会导致子模型绑定为null。

3. 控制器未做null检查和模型验证 #

在调用EF Core的Add()之前，你必须先验证模型是否有效、子实体是否存在：

[HttpPost]
public async Task<IActionResult> Create([FromBody] CreateGame model)
{
    // 先检查模型验证是否通过（比如必填项是否为空）
    if (!ModelState.IsValid)
    {
        return BadRequest(ModelState); // 返回具体的验证错误，方便排查
    }

    // 强制检查子实体是否为null
    if (model.StarSystem == null || model.Ship == null)
    {
        return BadRequest("必须提供StarSystem和Ship的完整数据");
    }

    // 确认实体非null后再执行添加操作
    _context.StarSystems.Add(model.StarSystem);
    _context.Ships.Add(model.Ship);
    await _context.SaveChangesAsync();

    return Ok(new { StarSystemId = model.StarSystem.Id, ShipId = model.Ship.Id });
}

4. 前端请求头缺失Content-Type #

不管是React前端还是Postman测试，都必须设置请求头Content-Type: application/json——如果没有这个头，.NET Core会忽略请求体的JSON数据，导致模型绑定失败。

快速排查步骤 #

1. 在控制器方法第一行打个断点，运行调试，查看model、model.StarSystem、model.Ship是否为null；
2. 如果模型为null，检查[FromBody]和请求头Content-Type；
3. 如果子属性为null，对比前端JSON结构和模型属性名是否匹配；
4. 输出ModelState.Values查看具体的绑定错误信息。

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