Asp.Net Core MVC Ajax标签助手：控制器返回异常未正常生效问题

你的问题核心有两个关键点：

1. AJAX标签助手没有指定更新目标容器，导致返回的局部视图错误内容无法渲染到页面上；
2. 控制器返回的是200 OK状态码（即使有业务异常），所以AJAX会触发success回调而非failure。

下面给出两种可行的解决方案，你可以根据需求选择：

方案一：在Success回调中处理业务错误（推荐，保持HTTP状态码语义） #

这种方案保持控制器返回200 OK，但在回调中检查视图模型的错误状态，手动处理错误展示。

步骤1：完善表单标签，添加更新目标 #

首先给你的AJAX表单加上data-ajax-update属性，指定要替换内容的DOM容器（比如模态框里的内容区域）：

<form class="m-form m-form--fit m-form--label-align-right" 
      id="formAddress" 
      asp-action="Create" 
      asp-controller="Address" 
      asp-area="Admin" 
      data-ajax="true" 
      data-ajax-method="POST" 
      data-ajax-complete="onComplete" 
      data-ajax-success="onSuccess" 
      data-ajax-failure="onFailed"
      data-ajax-update="#modalContent"> <!-- 新增：指定更新的容器ID -->

假设你的模态框内容容器ID是modalContent，需要和页面上的实际元素对应。

步骤2：优化视图模型的错误判断 #

把视图中判断错误的代码改成更严谨的空值检查：

@if (!string.IsNullOrEmpty(Model.ServiceError))
{
    <div class="alert alert-danger">@Model.ServiceError</div>
}

步骤3：修改Success回调函数 #

在onSuccess中检查返回内容是否包含错误提示，或者直接检查视图模型的错误标记（可以给视图模型加一个IsError布尔属性）：

function onSuccess(result) {
    // 检查是否存在错误提示
    const errorElement = $('.alert-danger', result);
    if (errorElement.length > 0) {
        // 有业务错误，滚动到错误位置提示用户
        $('html, body').animate({ 
            scrollTop: errorElement.offset().top 
        }, 500);
    } else {
        // 操作成功，关闭模态框并刷新数据列表
        $('#modalAddress').modal('hide');
        // 示例：刷新地址列表
        $('#addressList').load('/Admin/Address/List');
    }
}

方案二：返回非2xx状态码触发Failure回调 #

如果希望业务错误直接触发failure回调，可以让控制器在捕获异常时返回非2xx的HTTP状态码（比如422 不可处理的实体）。

步骤1：修改控制器方法 #

在捕获业务异常时，返回带状态码的PartialView：

[HttpPost]
[AutoValidateAntiforgeryToken]
public async Task<IActionResult> Create(ViewModel.AddressViewModel addressViewModel)
{
    try
    {
        if (ModelState.IsValid)
        {
            var newId = await _addressServiceClient.CreateAddress(addressViewModel);
            addressViewModel.Id = newId;
        }
    }
    catch (InvalidOperationException ioex)
    {
        ModelState.AddModelError(nameof(ViewModel.AddressViewModel), ioex.Message);
        addressViewModel.ServiceError = ioex.Message;
        // 返回422状态码，同时返回局部视图内容
        return new ObjectResult(PartialView("~/Areas/Shared/Views/_AddAddressPartial.cshtml", addressViewModel))
        {
            StatusCode = StatusCodes.Status422UnprocessableEntity
        };
    }
    catch (Exception ex)
    {
        addressViewModel.ServiceError = ex.Message;
        return new ObjectResult(PartialView("~/Areas/Shared/Views/_AddAddressPartial.cshtml", addressViewModel))
        {
            StatusCode = StatusCodes.Status422UnprocessableEntity
        };
    }
    // 无错误时返回正常局部视图
    return PartialView("~/Areas/Shared/Views/_AddAddressPartial.cshtml", addressViewModel);
}

步骤2：修改Failure回调函数 #

在onFailed中处理返回的错误内容，更新到模态框容器：

function onFailed(xhr) {
    if (xhr.status === 422) {
        // 更新模态框内容，显示业务错误
        $('#modalContent').html(xhr.responseText);
    } else {
        // 处理其他服务器错误（比如500）
        alert('服务器发生未知错误，请稍后重试');
    }
}

额外注意点 #

• 确保你的局部视图路径正确，控制器返回的PartialView路径必须和实际文件路径一致；
• 检查视图模型的ServiceError属性是否在异常时被正确赋值（比如避免空引用）；
• 如果使用方案一，建议给视图模型添加public bool IsError { get; set; }属性，在捕获异常时设置为true，这样在JS回调中可以更直接地判断，无需依赖DOM元素。

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