Ajax POST数据至Controller方法时参数始终为null的原因

问题场景 #

你的Controller方法接收string参数，但通过Ajax提交后参数始终为null：

Controller代码 #

public class ZTest : BaseController
{
    [HttpPost]
    public async Task<ActionResult> Test(string msg)
    {
        // 断点处msg始终为null
        return Json(ModelState.ToDataSourceResult());
    }
}

Ajax请求代码 #

$.ajax({
    type: 'POST',
    url: '@Url.Action("Test", "ZTest")',
    dataType: "json",
    contentType: "application/json; charset=utf-8",
    data: JSON.stringify({ msg: "Hello World" }),
    success: function (data) {
        if (data.exception) {
            Swal.fire("Error", data.message, "error");
        }
        else {
            Swal.fire("Success", "message", "success");
        }
    }
});

核心原因 #

1. 默认模型绑定规则：ASP.NET MVC对简单类型（如string、int）的参数，默认从**表单数据（Form Data）**中绑定，而你用contentType: "application/json"提交的是JSON格式的请求体，默认不会被绑定到简单类型参数上。
2. [FromBody]的使用误区：即使给参数加了[FromBody]，它对简单类型的期望是原始字符串（如直接传"Hello World"），而非包裹在{msg: "..."}里的对象结构，所以无法完成映射，参数依然为null。

可行解决方案 #

方案1：直接提交原始字符串（适配单一参数） #

修改Ajax请求的data为原始字符串，同时给Controller参数加上[FromBody]：

修改后的Controller

public class ZTest : BaseController
{
    [HttpPost]
    public async Task<ActionResult> Test([FromBody] string msg)
    {
        // 此时msg可正确获取值
        return Json(ModelState.ToDataSourceResult());
    }
}

修改后的Ajax

$.ajax({
    type: 'POST',
    url: '@Url.Action("Test", "ZTest")',
    dataType: "json",
    contentType: "application/json; charset=utf-8",
    data: JSON.stringify("Hello World"), // 直接传递字符串，而非对象
    success: function (data) {
        if (data.exception) {
            Swal.fire("Error", data.message, "error");
        }
        else {
            Swal.fire("Success", "message", "success");
        }
    }
});

方案2：用DTO类接收参数（适配多参数/保留对象结构） #

定义一个DTO类来匹配JSON对象结构，通过[FromBody]绑定整个对象：

定义DTO类

public class TestRequestDto
{
    public string Msg { get; set; }
}

修改后的Controller

public class ZTest : BaseController
{
    [HttpPost]
    public async Task<ActionResult> Test([FromBody] TestRequestDto request)
    {
        // request.Msg可获取到"Hello World"
        return Json(ModelState.ToDataSourceResult());
    }
}

Ajax代码保持不变

无需修改原Ajax请求，JSON对象的msg属性会自动映射到DTO的Msg属性（ASP.NET默认支持大小写不敏感匹配）。

方案3：改用表单格式提交（简化场景） #

如果不需要JSON格式，直接用默认的表单编码提交，无需JSON序列化：

修改后的Ajax

$.ajax({
    type: 'POST',
    url: '@Url.Action("Test", "ZTest")',
    dataType: "json",
    // 移除contentType，默认使用application/x-www-form-urlencoded
    data: { msg: "Hello World" }, // 直接传对象，不要JSON.stringify
    success: function (data) {
        if (data.exception) {
            Swal.fire("Error", data.message, "error");
        }
        else {
            Swal.fire("Success", "message", "success");
        }
    }
});

Controller代码保持不变

无需添加[FromBody]，模型绑定器会自动从表单数据中提取msg参数值。

为什么之前的尝试无效？ #

• 仅添加[FromBody]但仍传JSON对象：模型绑定器无法将对象转换为单一字符串，参数依然为null。
• 移除contentType但未去掉JSON.stringify：此时提交的是字符串形式的JSON，表单数据中参数名不匹配，导致绑定失败。

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