C#中[FromBody]数据绑定返回null的单元测试及空引用问题排查

我来帮你搞定这个单元测试的问题！首先得先理清两个核心点：为什么会出现NullReferenceException，以及如何正确测试[FromBody]绑定返回null的场景。

先分析你的异常根源 #

你遇到空引用异常，大概率是这两个原因之一：

1. 你的Action代码没做null判断：当模型绑定失败返回null时，你直接去访问模型的属性（比如model.Id），自然会炸。
2. 测试代码没先校验模型是否为null：你在断言环节直接去访问null模型的属性，导致异常。

另外要提一句：默认ASP.NET Core的模型绑定，对于引用类型模型，哪怕部分字段类型不匹配（比如int字段传"abc"），也会创建一个模型实例（只是错误字段保持默认值），而不是直接返回null。如果你的场景里模型确实是null，要么是JSON格式完全错误（比如语法错误），要么是你用了自定义模型绑定器。这点要先和你的实际场景对齐。

解决方案：一步步来 #

1. 先修复你的Action代码（避免运行时空引用）

不管测试怎么写，Action本身得先做好防御：

[HttpPost]
public IActionResult ProcessData([FromBody] MyRequestModel model)
{
    // 先判断模型是否为null，再检查ModelState有效性
    if (model == null || !ModelState.IsValid)
    {
        return BadRequest(ModelState);
    }

    // 后续业务逻辑
    return Ok("处理成功");
}

// 你的模型类示例
public class MyRequestModel
{
    public int RequiredIntField { get; set; }
    public string? OptionalString { get; set; }
}

2. 编写正确的单元测试

这里分两种测试方式：模拟真实HTTP请求（更贴近生产环境）和直接测试控制器方法（更轻量）。

方式一：用WebApplicationFactory模拟真实请求（推荐）

这种方式能完整模拟ASP.NET Core的模型绑定流程：

using Xunit;
using System.Net;
using System.Text;
using Microsoft.AspNetCore.Mvc.Testing;

public class DataBindingTests : IClassFixture<WebApplicationFactory<Program>>
{
    private readonly WebApplicationFactory<Program> _factory;

    public DataBindingTests(WebApplicationFactory<Program> factory)
    {
        _factory = factory;
    }

    [Fact]
    public async Task Post_InvalidIntValue_ReturnsBadRequest()
    {
        // Arrange：构造包含无效int值的JSON
        var client = _factory.CreateClient();
        var invalidJson = "{\"RequiredIntField\": \"abc\", \"OptionalString\": \"测试文本\"}";
        var requestContent = new StringContent(
            invalidJson, 
            Encoding.UTF8, 
            "application/json"
        );

        // Act：发送POST请求
        var response = await client.PostAsync("/api/yourcontroller/processdata", requestContent);

        // Assert：验证返回结果
        Assert.Equal(HttpStatusCode.BadRequest, response.StatusCode);
        
        // 可选：验证ModelState错误信息
        var errorResponse = await response.Content.ReadAsStringAsync();
        Assert.Contains("The value 'abc' is not valid for RequiredIntField.", errorResponse);
    }
}

方式二：直接测试控制器方法（轻量快速）

如果只想测试控制器的逻辑，手动模拟模型为null或ModelState错误的场景：

using Xunit;
using Microsoft.AspNetCore.Mvc;

public class YourControllerTests
{
    [Fact]
    public void ProcessData_ModelIsNull_ReturnsBadRequest()
    {
        // Arrange：实例化控制器
        var controller = new YourController();

        // Act：传入null模型调用Action
        var result = controller.ProcessData(null) as BadRequestObjectResult;

        // Assert：验证结果
        Assert.NotNull(result);
        Assert.Equal((int)HttpStatusCode.BadRequest, result.StatusCode);
    }

    [Fact]
    public void ProcessData_InvalidIntField_ReturnsBadRequest()
    {
        // Arrange：实例化控制器，手动添加ModelState错误
        var controller = new YourController();
        controller.ModelState.AddModelError(
            "RequiredIntField", 
            "The value 'abc' is not valid for RequiredIntField."
        );
        
        // 注意：这里模型不是null，而是部分绑定的实例，因为默认绑定不会返回null
        var model = new MyRequestModel { OptionalString = "测试文本" };

        // Act：调用Action
        var result = controller.ProcessData(model) as BadRequestObjectResult;

        // Assert：验证结果
        Assert.NotNull(result);
        Assert.Equal((int)HttpStatusCode.BadRequest, result.StatusCode);
        Assert.True(!controller.ModelState.IsValid);
    }
}

关键注意事项 #

• 如果你的场景中模型确实会返回null（比如JSON完全解析失败），在测试中要确保发送的是格式错误的JSON（比如缺少闭合括号），而不是仅仅字段类型不匹配。
• 测试时永远先断言模型是否为null，再去访问它的属性，避免测试代码本身抛出空引用异常。

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