能否单步调试ASP.NET Core模型绑定流程？绑定异常案例求助

问题概述 #

向ASP.NET Core的OnPost方法提交数据时，出现模型绑定失败，对象所有属性均为默认值，需通过单步调试模型绑定流程排查原因。

存在特殊场景：OnPostSaveFXRateAsync方法接收Fxrates类型的fxRate参数，对应的Ajax调用与其他十余处类似代码一致，但唯独此处绑定失败。已确认字段名和类型均匹配，最终将formData包裹在与参数同名的对象中才解决问题，需通过调试模型绑定流程理解原因。

相关代码 #

OnPost方法代码 #

public async Task<JsonResult> OnPostSaveFXRateAsync(Fxrates fxRate)
{
    fxRate.LastUpdatedBy = User.Identity.Name;

    bool isSuccess = await AL.SaveAndLogEntityAsync<Fxrates, int>(fxRate, Constants.Audit_Module_ControlCenter, User.Identity.Name);

    return new JsonResult(new { success = isSuccess });
}

初始Ajax调用代码 #

onClickSave = (e) =>
{
    let fxDate = $('#FXRate_Fxdate').data('kendoDatePicker').value();

    let formData =
    {
            Id: parseInt($('#FXRate_Id').val()),
            Fxdate: fxDate?.toYYYYMMDD(),
            FiscalPeriodTypeId: $('#FXRate_FiscalPeriodTypeId').val(),
            FromCurrencyId: $('#FXRate_FromCurrencyId').val(),
            ToCurrencyId: $('#FXRate_ToCurrencyId').val(),
            Fxrate: parseFloat($('#FXRate_Fxrate').val())
    };

    console.log(formData);

    let validator = $('#frmFXRate').kendoValidator().data('kendoValidator');
    console.log(validator);

    if (validator.validate())
    {
        $.ajax({
            type: 'POST',
            url: '/Admin/ControlCenter/FXRateDetails?handler=SaveFXRate',
            data: formData,
            content: 'application/json; charset=utf-8',
            headers: { 'RequestVerificationToken': $("input[name='__RequestVerificationToken']").val() },
            success: function (response)
            {
                console.log('save successful');
                window.parent.$('#FXRatesGrid').data('kendoGrid').dataSource.read();
                window.parent.$("#DetailsWnd").data("kendoWindow").close();
            },
            error: function (xhr, textStatus, errorThrown)
            {
                console.log('Save failed');
            }
        });
    }
    else
    {
        console.log('Form data invalid');
    }
}

修复后的formData代码 #

let formData =
{
    fxRate: {
        Id: parseInt($('#FXRate_Id').val()),
        Fxdate: fxDate?.toYYYYMMDD(),
        FiscalPeriodTypeId: $('#FXRate_FiscalPeriodTypeId').val(),
        FromCurrencyId: $('#FXRate_FromCurrencyId').val(),
        ToCurrencyId: $('#FXRate_ToCurrencyId').val(),
        Fxrate: parseFloat($('#FXRate_Fxrate').val())
    }
};

Fxrates类代码 #

public partial class Fxrates
{
    public int Id { get; set; }

    public DateTime Fxdate { get; set; }

    public string FiscalPeriodTypeId { get; set; }
    public string FromCurrencyId { get; set; }
    public string ToCurrencyId { get; set; }

    public decimal Fxrate { get; set; }

    public DateTime CreatedDate { get; set; }
    public DateTime LastUpdatedDate { get; set; }
    public string LastUpdatedBy { get; set; }

    public virtual FiscalPeriodType FiscalPeriodType { get; set; }
    public virtual Currency FromCurrency { get; set; }
    public virtual User LastUpdatedByNavigation { get; set; }
    public virtual Currency ToCurrency { get; set; }
}

模型绑定流程调试步骤 #

• 启用符号加载：在Visual Studio调试选项中勾选“Microsoft符号服务器”，确保能加载ASP.NET Core框架的调试符号。
• 设置断点：
  • 在ControllerBase.OnActionExecuting方法设置断点，查看ModelState初始状态。
  • 在DefaultModelBinder的BindAsync方法设置断点，跟踪绑定全过程。
• 检查请求数据：调试时查看HttpContext.Request的Content-Type和提交的数据结构，确认是否符合绑定器预期。
• 分析ModelState：在OnPost方法开头检查ModelState.IsValid，若无效则遍历ModelState.Values查看具体错误，定位绑定失败的字段和原因。

特殊场景原因分析 #

1. Ajax参数错误：初始Ajax代码误用content参数，正确参数应为contentType，导致jQuery默认以application/x-www-form-urlencoded格式发送数据，而非预期的JSON。
2. 表单编码绑定要求：以application/x-www-form-urlencoded发送扁平数据时，模型绑定器需要参数名带前缀（如fxRate.Id）才能绑定到Fxrates类型的fxRate参数。初始代码的扁平formData提交的键是Id、Fxdate等，无法匹配绑定器预期，导致绑定失败。
3. 其他场景隐性适配：其他十余处代码要么正确设置contentType: 'application/json'并使用JSON.stringify(formData)发送JSON（扁平结构可直接绑定），要么表单元素name属性已带fxRate.前缀，因此无需手动包裹对象。

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