.NET OnPost方法参数始终传为null问题排查求助

我编写了一个OnPostSavePDFStatement方法，用于接收PDF二进制数据字符串、文件名和员工ID整数，代码如下：

public JsonResult OnPostSavePDFStatement(string pdfData, string filename, int employeeId)
{
    pdfData = pdfData.Replace("data:application/pdf;base64,", "");
    var fileContents = Convert.FromBase64String(pdfData);

    DL.SavePDFStatement(filename, employeeId, User.Identity.Name, fileContents);

    return new JsonResult(new { result = true });
}

问题在于pdfData、filename和employeeId三个参数始终被传为null。我使用jQuery的Ajax发送数据到服务器：

$.ajax({
    type: "POST",
    url: "/Statement/MyStatementsPDF?handler=SavePDFStatement",
    data: formData,
    content: "application/json; charset=utf-8",
    headers: { "RequestVerificationToken": $('input[name="__RequestVerificationToken"]').val() },
    success: function (response)
    {
    },
    error: function (xhr, textStatus, errorThrown)
    {
        console.log('Error saving PDF to DB');
    }
});

已确认客户端formData填充正确，通过Fiddler也能看到三个参数已发送，但参数仍为null。此外，移除pdfData参数后，employeeId和filename能正常传递。想知道在.NET的绑定流程中哪里可以设置断点排查失败原因？

先修正客户端请求的明显错误 #

你在Ajax配置里写了content: "application/json; charset=utf-8"，这是拼写错误，正确的属性名是contentType。另外，如果你发送的是FormData，不需要手动设置contentType，让jQuery自动生成multipart/form-data请求头即可，否则会导致请求格式不匹配，大体积的base64字符串更容易触发绑定失败。

.NET绑定流程中的断点位置 #

1. 模型绑定入口：在Microsoft.AspNetCore.Mvc.ModelBinding.DefaultModelBinder类的BindModelAsync方法设置断点，这是模型绑定的核心入口，可以追踪每个参数的绑定流程，查看绑定失败的具体原因。
2. 简单类型绑定细节：针对字符串、整数这类简单参数，在Microsoft.AspNetCore.Mvc.ModelBinding.Binders.SimpleTypeModelBinder的BindModelAsync方法设断点，查看单个参数的解析过程。
3. 请求上下文校验：在控制器的OnActionExecuting方法中设置断点，检查HttpContext.Request.Form（FormData场景）的内容，确认服务器端是否接收到完整的参数数据，同时可以查看ModelState.IsValid状态和错误信息。
4. 表单长度限制检查：如果pdfData是较长的base64字符串，可能超出了.NET默认的表单值长度限制。可以直接在Program.cs/Startup.cs中调整限制，也可以在Microsoft.AspNetCore.Http.Features.FormOptions的相关配置代码处设断点验证：

builder.Services.Configure<FormOptions>(options =>
{
    options.ValueLengthLimit = 10485760; // 设置为10MB，根据实际需求调整
    options.MultipartBodyLengthLimit = 10485760;
});

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