ASP.NET WebForms中Ajax调用非静态WebMethod报错解决方法

两个报错均为ASP.NET WebForm页级WebMethod写法不符合框架规范导致：

1. 初始版本返回服务器错误：页内标记[WebMethod]的接口方法不能是protected实例方法。这类Ajax直调的方法不会走完整WebForm页面生命周期，不会实例化页面对象，实例方法无法被路由命中。
2. 改为静态方法后提示需要实例化对象：原因是静态方法内部直接调用了页面实例成员（比如通过this访问页面控件、页面级字段/属性），静态方法不属于页面对象实例，无法直接访问实例内容。

1. 前端Ajax补全必要请求配置 #

WebMethod默认只接收application/json类型的POST请求，原代码未指定请求内容类型，会被ASP.NET拦截返回错误，修正后代码如下：

setInterval(function () {
    $.ajax({
        url: 'CameraDashboard.aspx/LoadNotifications',
        type: 'POST',
        // 必须添加以下请求头配置
        contentType: "application/json; charset=utf-8",
        dataType: "json",
        data: "{}", // 无参数时传空JSON对象，有参数按键值对序列化后传入，例：JSON.stringify({cameraId: 1001})
        success: function (res) {
            // WebMethod会自动将返回内容包裹在d字段下做XSS防护，实际数据从res.d取
            const notifyData = JSON.parse(res.d);
            console.log('通知加载成功', notifyData);
            // 在此处编写更新页面DOM的逻辑
        },
        error: function (xhr) {
            console.log('请求失败', xhr.responseText);
        }
    })
}, 60000);

2. 后端WebMethod按规范编写 #

方法必须声明为public static，如果需要返回数据给前端不要用void返回类型；需要访问请求上下文、Session等内容时，通过HttpContext.Current获取，禁止直接通过this关键字访问页面实例成员：

using System.Web.Services;
using System.Web.Script.Serialization;

public partial class CameraDashboard : System.Web.UI.Page
{
    [WebMethod]
    public static string LoadNotifications()
    {
        // 需要访问请求、Session等上下文时通过以下方式获取，不要直接调用Page实例成员
        // HttpContext currentContext = HttpContext.Current;
        // object loginUser = currentContext.Session["LoginUser"];
        
        // 编写业务逻辑，查询需要返回的通知数据
        var result = new {
            UnreadCount = 2,
            LatestContent = "3号摄像头离线告警",
            UpdateTime = System.DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss")
        };

        // 序列化数据为JSON格式返回前端
        JavaScriptSerializer serializer = new JavaScriptSerializer();
        return serializer.Serialize(result);
    }
}

• WebMethod必须加public访问修饰符，protected/private都会导致路由匹配失败
• 不要遗漏static关键字，实例方法无法被页级路由直接调用
• 前端传参必须使用JSON格式，参数名和后端方法形参名完全一致（大小写敏感）
• 若方法内需要访问Session，需给WebMethod追加特性配置：[WebMethod(EnableSession = true)]
• 不要在静态方法内直接操作页面服务端控件，所有DOM更新逻辑放在前端Ajax的success回调中完成

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