ASP.NET WebForms中AJAX调用后无法触发回调的问题排查

核心问题分析 #

出现Uncaught TypeError: PageMethods.DisableUserStatus() is not a function错误，以及成功/失败回调不触发，主要有三个关键问题：

1. 前端调用语法错误 #

你写的PageMethods.DisableUserStatus()("", OnSucceeded, OnFailed);是错误写法，PageMethods的方法调用不需要额外嵌套括号，且后台方法无参数时，直接传入回调函数即可。

2. 后台WebMethod实现错误 #

• 返回类型错误：不应返回JavaScriptSerializer对象，ASP.NET框架会自动处理数据序列化，直接返回要传递的内容（字符串、对象等）即可。
• 缺少返回语句：当前代码仅执行了序列化操作，但未将结果返回给前端。

3. 页面未配置ScriptManager #

ASP.NET WebForms使用PageMethods必须在页面添加ScriptManager控件并启用PageMethods，否则前端不会生成PageMethods对象。

修正后的代码 #

后台VB代码 #

<WebMethod()>
Public Shared Function DisableUserStatus() As String
    Users.UpdateUserStatus("EXTERNALUSER", False)
    ' 直接返回结果，框架自动处理序列化
    Return "Success"
End Function

前端ASPX页面配置与脚本 #

首先在页面添加ScriptManager控件：

<asp:ScriptManager ID="ScriptManager1" runat="server" EnablePageMethods="true"></asp:ScriptManager>

然后修正JavaScript代码：

$(document).ready(function () {
    $('#btnDisableUserStatus').click(function () {
        let result = confirm('Are you sure you want to disable users?');                
        if (result) {
            DisableUserStatus();
        }                
    });
});

function DisableUserStatus() {
    // 无参数时直接传入回调函数
    PageMethods.DisableUserStatus(OnSucceeded, OnFailed); 
}

function OnSucceeded(result) { 
    alert(result);
}

function OnFailed(error) { 
    alert(error.get_message());
}

额外注意事项 #

• 确保按钮btnDisableUserStatus是普通HTML按钮，或是设置了UseSubmitBehavior="false"的ASP.NET按钮，避免页面自动提交中断AJAX请求。
• 可通过Chrome开发者工具的Console面板排查是否存在其他JS错误。
• 若后台方法需要接收参数，调用格式为PageMethods.MethodName(param1, param2, OnSucceeded, OnFailed)。

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