ASP.NET WebMethod接收类参数时无法调用，单独传参正常

我之前也碰到过一模一样的坑！核心问题出在Ajax传递的JSON结构和WebMethod的参数不匹配上，咱们一步步来排查和解决：

1. 先确认WebMethod的参数结构 #

假设你的后端类和WebMethod定义是这样的（如果不是，要对应调整）：

// 你的实体类，必须是public且属性带get/set
public class InventoryItem
{
    public int Id { get; set; }
    // 其他需要的属性...
}

[WebMethod(EnableSession = true)]
// 参数名是item，这个名字很重要！
public static void Update(InventoryItem item)
{
    // 你的业务逻辑...
}

2. 修正Ajax的JSON传递结构 #

你现在直接序列化了{Id:1234}，但WebMethod期望接收的是以参数名为键的包裹式JSON——也就是要把你的对象放到和参数名一致的键下面。

修改后的Ajax代码：

var obj = {Id: 1234};
// 关键：用WebMethod的参数名作为键，包裹你的对象
var item = JSON.stringify({ item: obj }); 
$.ajax({
    url: 'InventoryItems.aspx/Update',
    data: item,
    type: 'POST',
    dataType: "json",
    contentType: "application/json; charset=utf-8",
    success: function () {
        console.log("in success");
    },
    // 强烈建议加error回调，方便排查问题
    error: function(xhr, status, error) {
        console.log("错误详情：", xhr.responseText);
    }
})

3. 其他需要检查的坑点 #

• 实体类的属性必须是public且带有get/set访问器，不然ASP.NET的JSON序列化器无法解析属性值。
• WebMethod必须是static静态方法，这是ASP.NET WebMethod的硬性要求。
• 如果类里有复杂属性（比如嵌套类、集合），要确保它们没有循环引用，且能被正常序列化。

如果还是有问题，打开浏览器控制台看error回调里的xhr.responseText，里面会有详细的错误提示（比如参数不匹配、序列化失败原因），能帮你快速定位问题。

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