.NET Core MVC控制器POST方法接收表单数据为空，如何定位错误？

常见排查&修复步骤 #

• 若控制器添加了[ApiController]特性，默认以JSON格式解析请求体，接收表单参数必须为入参添加[FromForm]标记：

[HttpPost]
public IActionResult 你的方法名([FromForm] 你的接收模型 入参名)
{
    // 业务逻辑
}

• 检查前端表单配置：普通表单提交需设置enctype="application/x-www-form-urlencoded"，带文件提交需设置enctype="multipart/form-data"；AJAX提交时无需手动设置Content-Type请求头，交由浏览器自动生成即可。
• 核对表单字段name属性值和接收模型属性名/单个入参名完全匹配，.NET Core模型绑定大小写敏感，拼写错误会导致绑定失败。
• 检查是否存在自定义中间件提前读取了Request.Body且未重置流的位置，会导致后续模型绑定无法读取到内容，可添加Request.EnableBuffering()开启请求体重读，读取完成后将Request.Body.Position = 0重置流位置。
• AJAX提交时直接传递FormData对象即可，不要将表单内容序列化为JSON字符串传递：

// 示例代码
const form = document.getElementById('表单ID');
const formData = new FormData(form);
fetch('/控制器名/方法名', {
  method: 'POST',
  body: formData
}).then(res => res.json())

问题验证方法 #

可通过以下代码直接读取原始请求体，确认表单数据是否正常传递到后端：

[HttpPost]
public async Task<IActionResult> DebugRequestBody()
{
    Request.EnableBuffering();
    var bodyStr = await new StreamReader(Request.Body).ReadToEndAsync();
    Request.Body.Position = 0;
    // 打印bodyStr即可查看原始请求内容
    return Ok(bodyStr);
}

相关参考截图 #

内容的提问来源于stack exchange，提问作者ZFC AKADEMİ