Razor Pages发起多参数AJAX POST请求时服务端接收参数为null的问题

出现服务端方法能正常触发但接收参数全为null的现象，本质是Razor Pages参数绑定规则与AJAX请求配置不匹配导致的。
Razor Pages的参数绑定有明确的场景边界：

• 当请求Content-Type为默认表单格式（application/x-www-form-urlencoded）时，绑定器会将表单内的键值对，直接映射到处理方法定义的零散简单类型参数（即当前方法中的string fname、string lname）
• 当请求Content-Type为application/json时，绑定器不会主动拆解JSON请求体的顶层字段去匹配零散参数，仅会将整个请求体的JSON内容，绑定到单个标记了[FromBody]的模型对象上

之前两次测试均失败的原因，刚好对应规则的两个盲区：

• 配置JSON提交的场景：设置了contentType: application/json + JSON.stringify序列化时，后端无对应从JSON body读取零散参数的逻辑，因此两个参数始终为null
• 尝试不序列化的场景：未移除原有JSON contentType配置时，jQuery不会自动将普通JS对象转换为表单编码格式提交，后端收到的请求体不符合表单结构要求，无法匹配参数

方案1：保留现有后端方法结构，调整AJAX配置适配表单提交 #

无需修改OnPostGenerate(string fname, string lname)的后端定义，仅需移除AJAX配置中的JSON相关参数即可：

$.ajax({
    type: "POST",
    url: "Index?handler=Generate",
    dataType: "json",
    headers: {
        RequestVerificationToken:
            $('input:hidden[name="__RequestVerificationToken"]').val()
    },
    // 移除原有application/json的contentType配置，使用jQuery默认的表单编码格式
    data: {
        fname: "testFirstname",
        lname: "testLastname"
    },
    success: function (data) {
        alert(data);
    }
});

调整后提交的请求为标准表单格式，后端可自动将键值对映射到两个方法参数上。

方案2：保留JSON提交配置，调整后端方法适配JSON绑定 #

如果业务场景要求使用application/json格式提交请求，不能直接在方法参数中定义零散简单类型，需定义对应输入模型，通过[FromBody]标记接收整个请求体内容：

1. 定义与JSON结构匹配的输入模型类：

   public class GenerateRequestModel
   {
       public string Fname { get; set; }
       public string Lname { get; set; }
   }
   

2. 修改后端处理方法：

   public async Task<IActionResult> OnPostGenerate([FromBody] GenerateRequestModel input)
   {
       return new JsonResult(input.Fname + input.Lname);
   }
   

不要给多个零散的string参数分别添加[FromBody]标记。ASP.NET Core模型绑定规则中，标记[FromBody]的参数仅会读取一次请求流，多个参数同时使用该标记时，仅第一个参数可正常取值，其余参数均为null，必须通过单个模型类封装所有参数。

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