C#应用HTTPS下AJAX请求控制器无自定义400错误信息问题

问题原因 #

HTTPS模式下，IIS默认会拦截4xx类错误响应（比如400 Bad Request），将自定义的响应内容替换为系统默认的HTML错误页，导致前端AJAX无法获取控制器中设置的自定义错误信息；而HTTP模式下IIS未启用该拦截，所以能正常拿到自定义信息。

解决方案 #

方案1：将错误信息放在JSON响应体中（推荐） #

放弃通过Response.StatusDescription传递错误信息，直接把错误内容封装到返回的JSON对象里，这样即使IIS拦截了状态描述，前端仍能解析响应体拿到自定义信息。

修改控制器代码：

// 构造包含错误信息的响应对象
var responseData = new {
    IsSuccess = false,
    ErrorMessage = error.Mensaje,
    // 其他需要返回的数据
};

// 返回带400状态码的JSON响应
return new JsonResult(responseData) {
    StatusCode = (int)HttpStatusCode.BadRequest
};

修改前端AJAX的错误回调：

error: function (err) {
    // 尝试解析响应体中的自定义错误信息
    if (err.responseJSON) {
        alert(err.responseJSON.ErrorMessage);
    } else {
        // 兜底显示通用错误
        alert(err.statusText);
    }
}

方案2：配置IIS允许传递自定义错误响应 #

通过修改web.config，让IIS直接传递应用返回的自定义响应，不替换为默认错误页。

在web.config的<system.webServer>节点下添加：

<httpErrors existingResponse="PassThrough" />

如果需要更精确控制，只针对400错误设置：

<httpErrors>
    <remove statusCode="400" subStatusCode="-1" />
    <error statusCode="400" subStatusCode="-1" responseMode="PassThrough" />
</httpErrors>

方案3：关闭ASP.NET自定义错误拦截 #

检查web.config中<system.web>节点下的<customErrors>配置，确保它不会拦截自定义响应：

<customErrors mode="Off" />

注意：mode="RemoteOnly"会对远程请求（非本地）启用错误页替换，如果你是远程访问HTTPS站点，需要改为mode="Off"或者确保自定义错误能正常传递。

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