.NET Core API自定义401消息，HttpWebRequest如何获取？

这个问题我之前踩过类似的坑，核心原因是**HttpWebRequest的默认行为**：当服务器返回非2xx的状态码（比如你的401）时，它不会直接返回响应对象，而是直接抛出WebException，你现在看到的"远程服务器返回错误: (401) Unauthorized."其实是这个异常的默认提示，而非API返回的自定义消息。

解决方向1：修改客户端代码，捕获WebException并提取响应内容 #

你需要在客户端代码中添加对WebException的捕获，从异常对象里拿到服务器返回的响应流，进而读取自定义错误消息。修改后的代码示例如下：

try
{
    var response = request.GetResponse() as HttpWebResponse;
    var responseEncoding = Encoding.GetEncoding(response.CharacterSet);
    using (var sr = new StreamReader(response.GetResponseStream(), responseEncoding))
    {
        var result = sr.ReadToEnd();
        return JsonConvert.DeserializeObject<T>(result);
    }
}
catch (WebException ex)
{
    // 当服务器返回错误状态码时，异常的Response属性会包含对应的响应对象
    if (ex.Response is HttpWebResponse errorResponse)
    {
        using (var reader = new StreamReader(errorResponse.GetResponseStream()))
        {
            // 这里就能读取到API返回的"My custom error"了
            var customErrorMessage = reader.ReadToEnd();
            // 你可以根据业务需求处理这个消息，比如返回错误信息或者重新抛出带自定义消息的异常
            throw new InvalidOperationException(customErrorMessage, ex);
        }
    }
    // 处理其他网络异常情况
    throw;
}

解决方向2：改用HttpClient（更推荐） #

HttpWebRequest是比较老旧的API，.NET Core/.NET 5+更推荐使用HttpClient，它对非成功状态码的处理更友好，不会直接抛出异常，你可以自由读取响应内容：

using (var client = new HttpClient())
{
    client.BaseAddress = new Uri(baseUrl);
    HttpResponseMessage response;

    if (parameters == null)
    {
        response = await client.PostAsync(url, null);
    }
    else
    {
        var content = new StringContent(serializedObject, Encoding.UTF8, "application/json");
        response = await client.PostAsync(url, content);
    }

    // 先读取全部响应内容，不管状态码是否成功
    var responseContent = await response.Content.ReadAsStringAsync();

    if (response.IsSuccessStatusCode)
    {
        return JsonConvert.DeserializeObject<T>(responseContent);
    }
    else
    {
        // 这里直接就能拿到自定义错误消息
        throw new Exception($"请求失败 ({(int)response.StatusCode}): {responseContent}");
    }
}

额外确认：你的API代码是没问题的 #

你的.NET Core API代码逻辑是正确的，当抛出UnauthorizedAccessException时，确实会返回401状态码和自定义消息，问题完全出在客户端对错误响应的处理上。

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