ASP.NET部署Azure WebApp后，HTTP/HTTPS访问接口401状态文本不一致问题

我之前也碰到过类似的情况，结合Azure Web App的代理机制和ASP.NET身份验证的特性，给你几个可行的排查和解决方向：

1. 先配置转发头，让ASP.NET识别HTTPS请求 #

Azure Web App会在前端终止HTTPS连接，然后用HTTP把请求转发到你的应用程序。如果ASP.NET不知道这个情况，身份验证中间件的响应行为就会出现差异。

在你的Program.cs（.NET 6+）或者Startup.cs中，一定要先配置转发头，再启用身份验证：

// .NET 6+ Program.cs
app.UseForwardedHeaders(new ForwardedHeadersOptions
{
    ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto
});

// 接着启用身份验证和授权
app.UseAuthentication();
app.UseAuthorization();

这个配置会让ASP.NET读取Azure传递的X-Forwarded-Proto头，识别出原始请求是HTTPS，从而统一响应逻辑。

2. 检查Azure Web App的HTTPS相关设置 #

登录Azure Portal，进入你的Web App：

• 转到设置 > TLS/SSL设置，开启「HTTPS Only」（强制所有请求走HTTPS，避免混合请求的问题），同时确保TLS版本设置为1.2或更高；
• 转到配置 > 常规设置，检查「HTTP版本」是否设置为1.1或2.0，旧版本的HTTP协议可能会导致响应处理异常。

3. 自定义401响应，彻底统一输出 #

如果上面的配置调整后还是有差异，直接自定义身份验证中间件的401响应，不管请求是HTTP还是HTTPS，都返回相同的内容：

// .NET 6+ 配置Cookie身份验证时添加自定义事件
builder.Services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme)
    .AddCookie(options =>
    {
        options.Events = new CookieAuthenticationEvents
        {
            OnRedirectToLogin = context =>
            {
                // 针对AJAX请求，返回401而不是重定向到登录页
                if (string.Equals(context.Request.Headers["X-Requested-With"], "XMLHttpRequest", StringComparison.OrdinalIgnoreCase))
                {
                    context.Response.StatusCode = StatusCodes.Status401Unauthorized;
                    context.Response.ContentType = "application/json";
                    // 这里统一设置响应文本，比如你需要的"Please sign in"
                    return context.Response.WriteAsync("{\"message\": \"Please sign in\"}");
                }
                return base.OnRedirectToLogin(context);
            }
        };
    });

这样所有AJAX请求的401响应都会保持一致，不会再出现HTTP和HTTPS的差异。

4. 前端AJAX的响应处理优化 #

有时候前端的AJAX配置也会影响你获取到的状态文本，建议在错误回调里直接读取响应体的内容，而不是依赖status参数：

jQuery.ajax({
    url: "/someUrl",
    type: "GET",
    contentType: 'application/json; charset=utf-8',
    dataType: "json",
    success: function(data) {
        // 处理成功逻辑
    },
    error: function(xhr, status, error) {
        // 直接读取响应体的消息更可靠
        const errorMsg = JSON.parse(xhr.responseText).message;
        console.log("授权失败：", errorMsg);
    }
});

总的来说，最常见的原因就是Azure的HTTPS代理没有被ASP.NET正确识别，配置转发头就能解决大部分问题；如果还是不行，自定义响应是最稳妥的方案。

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