ASP.NET Core MVC中jQuery Ajax无法向控制器方法传递参数

这种情况我之前也碰到过好几次——Ajax明明触发了控制器方法，但参数就是没值，大概率是这几个地方出了问题，咱们一步步排查：

这是最常见的坑！很多人会忘了设置contentType，或者直接传JavaScript对象而不转成JSON字符串，导致MVC无法正确解析模型。

前端Ajax示例（正确写法）： #

// 构造你的模型对象
var userModel = {
    Name: "张三",
    Age: 28,
    Email: "zhangsan@example.com"
};

$.ajax({
    url: "/User/SaveUser",
    type: "POST",
    // 必须指定这个内容类型，告诉服务器接收的是JSON
    contentType: "application/json; charset=utf-8",
    // 一定要用JSON.stringify把对象转成JSON字符串
    data: JSON.stringify(userModel),
    success: function(response) {
        console.log("操作成功：", response);
    },
    error: function(xhr) {
        console.log("请求出错：", xhr.responseText);
    }
});

控制器对应写法： #

ASP.NET Core需要给参数加[FromBody]标记（ASP.NET MVC可以不用，但加上更稳妥），同时要确保方法标记了[HttpPost]：

[HttpPost]
public IActionResult SaveUser([FromBody] UserModel model)
{
    if (ModelState.IsValid)
    {
        // 处理你的业务逻辑
        return Json(new { success = true, message = "保存成功" });
    }
    // 如果模型验证失败，返回错误信息
    var errors = ModelState.Values.SelectMany(v => v.Errors.Select(e => e.ErrorMessage));
    return Json(new { success = false, errors = errors });
}

// 对应的模型类（必须是public）
public class UserModel
{
    public string Name { get; set; }
    public int Age { get; set; }
    public string Email { get; set; }
}

JavaScript是大小写敏感的！前端对象的属性名必须和后端模型的属性名完全一致（包括大小写）。比如前端写的是username，后端模型是UserName，就会匹配失败。

如果不想改前端代码，可以在模型上用[JsonProperty]指定别名：

public class UserModel
{
    [JsonProperty("username")]
    public string UserName { get; set; }
}

GET请求不适合直接传复杂模型，因为GET没有请求体，参数会拼在URL里。如果一定要用GET传模型，需要把对象序列化成查询字符串：

前端写法： #

var userModel = { Name: "张三", Age: 28 };
$.ajax({
    url: "/User/GetUser?" + $.param(userModel), // 用$.param把对象转成查询参数
    type: "GET",
    success: function(response) { ... }
});

控制器写法： #

GET方法的参数不能加[FromBody]，直接接收模型即可：

[HttpGet]
public IActionResult GetUser(UserModel model)
{
    // 处理逻辑
}

⚠️ 注意：GET传复杂模型（比如带嵌套对象的）容易出问题，建议复杂数据还是用POST传递。

模型类必须是public的，而且要有无参构造函数（默认会自动生成，但如果你手动写了带参构造函数，必须显式添加无参的），不然MVC无法实例化模型：

public class UserModel
{
    // 必须要有这个无参构造函数
    public UserModel() { }

    // 如果你有带参构造函数，也得保留无参的
    public UserModel(string name)
    {
        Name = name;
    }

    public string Name { get; set; }
}

有时候参数能传过来，但因为验证规则（比如必填项为空、类型不匹配）导致模型绑定失败。你可以在控制器里打印错误信息：

[HttpPost]
public IActionResult SaveUser([FromBody] UserModel model)
{
    if (!ModelState.IsValid)
    {
        // 把错误信息返回给前端，方便排查
        var errorMessages = ModelState.Values
            .SelectMany(v => v.Errors)
            .Select(e => e.ErrorMessage);
        return Json(new { success = false, errors = errorMessages });
    }
    // 业务逻辑...
}

先从第1点开始排查，这是最容易踩的坑，一般解决了这个问题数据就能正常传递了。

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