ASP.NET Core 6 MVC部署Ubuntu后邮件确认链接返回空响应问题

问题根源 #

HAProxy作为前置代理处理HTTPS请求后，以HTTP方式转发到Kestrel，但ASP.NET Core默认无法识别原始请求的协议（HTTPS），导致生成的链接为HTTP，且授权相关的重定向逻辑因协议不匹配返回空响应。

解决方案步骤 #

1. 配置HAProxy传递正确的代理头信息

在HAProxy的配置文件中，为后端ASP.NET Core应用添加X-Forwarded-Proto、X-Forwarded-For、X-Forwarded-Host头，告知后端原始请求的协议、客户端IP和主机名：

backend aspnetcore_app
    server app1 127.0.0.1:5000 check  # 指向Kestrel监听的HTTP端口
    # 当请求通过HTTPS到达HAProxy时，设置X-Forwarded-Proto为https
    http-request set-header X-Forwarded-Proto https if { ssl_fc }
    # 传递客户端真实IP
    http-request set-header X-Forwarded-For %[src]
    # 传递原始请求的Host头
    http-request set-header X-Forwarded-Host %[req.hdr(Host)]

2. 在ASP.NET Core中启用正向代理支持

修改Program.cs，添加并启用ForwardedHeaders中间件，让应用信任HAProxy传递的代理头，从而识别原始请求的HTTPS协议。注意：此中间件必须放在UseHttpsRedirection、UseRouting等中间件之前：

var builder = WebApplication.CreateBuilder(args);

// 配置正向代理头处理
builder.Services.Configure<ForwardedHeadersOptions>(options =>
{
    // 启用转发的协议和客户端IP头
    options.ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto;
    // 添加HAProxy的IP地址到可信代理列表，若HAProxy在本地则填127.0.0.1，远程则填实际IP
    options.KnownProxies.Add(IPAddress.Parse("127.0.0.1"));
    // 若HAProxy在一个网段内，可配置网段替代单个IP：
    // options.KnownNetworks.Add(new IPNetwork(IPAddress.Parse("192.168.1.0"), 24));
});

// 原有服务配置（示例）
builder.Services.AddControllersWithViews();
builder.Services.AddDefaultIdentity<IdentityUser>(options => options.SignIn.RequireConfirmedAccount = true)
    .AddEntityFrameworkStores<ApplicationDbContext>();

var app = builder.Build();

// 启用正向代理头处理，必须放在其他中间件之前
app.UseForwardedHeaders();

// 配置HTTP到HTTPS的重定向
app.UseHttpsRedirection();

// 原有中间件配置
app.UseStaticFiles();
app.UseRouting();
app.UseAuthentication();
app.UseAuthorization();

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");
app.MapRazorPages();

app.Run();

3. 补充配置（可选）

• Kestrel监听配置：确保Kestrel仅监听HTTP端口（由HAProxy转发），在appsettings.json中添加：

  {
    "Kestrel": {
      "Endpoints": {
        "Http": {
          "Url": "http://0.0.0.0:5000"
        }
      }
    }
  }
  

• HTTPS重定向端口配置：若需要指定重定向的HTTPS端口（默认443），在appsettings.json中添加：

  {
    "HttpsRedirection": {
      "SslPort": 443
    }
  }
  

验证效果 #

配置完成后重启HAProxy和ASP.NET Core应用：

• 用户注册生成的邮件确认链接会自动使用HTTPS协议；
• 访问带有[Authorize]特性的控制器时，会正确重定向到HTTPS登录页面，不再返回空响应；
• 手动访问HTTP地址会自动重定向到HTTPS。

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