从.NET Core 3迁移的.NET Core 8应用配置自签名证书HTTPS报错

你的问题出在错误的配置位置：app.UseHttps()中间件的作用是强制HTTP请求跳转至HTTPS，并非用来指定Kestrel要使用的服务器证书。证书的配置应该在Kestrel的服务启动配置阶段完成，而不是中间件管道中。

正确的配置步骤 #

1. 确认证书文件路径 #

确保你的certificate.pfx文件：

• 放置在项目根目录下
• 在Visual Studio中右键文件→属性，设置复制到输出目录为「如果较新则复制」，保证运行时能找到证书文件

2. 在Program.cs中配置Kestrel（.NET 8顶级语句模式） #

如果你的项目使用.NET 8默认的顶级语句结构，直接在Program.cs中添加Kestrel的证书配置：

var builder = WebApplication.CreateBuilder(args);

// 配置Kestrel监听HTTPS端口并指定自定义证书
builder.WebHost.ConfigureKestrel(options =>
{
    // 监听所有IP的5001端口（可根据需求修改端口）
    options.ListenAnyIP(5001, listenOptions =>
    {
        listenOptions.UseHttps("certificate.pfx", "password");
    });
    // 可选：同时监听HTTP端口（如5000）
    options.ListenAnyIP(5000);
});

// 注册你的服务（如MVC、API等）
builder.Services.AddControllersWithViews();

var app = builder.Build();

// 中间件配置（这里用UseHttpsRedirection做HTTP跳转）
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();

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

app.Run();

3. 保留Startup.cs结构的配置方式（从.NET Core 3迁移的项目） #

如果你的项目仍使用传统的Startup.cs，需要在Program.cs的主机配置中添加Kestrel设置：

public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseStartup<Startup>()
                    .ConfigureKestrel(options =>
                    {
                        options.ListenAnyIP(5001, listenOptions =>
                        {
                            listenOptions.UseHttps("certificate.pfx", "password");
                        });
                    });
            });
    }
}

然后在Startup.cs的Configure方法中，将原有的app.UseHttps()替换为app.UseHttpsRedirection()：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
    else
    {
        app.UseExceptionHandler("/Home/Error");
        app.UseHsts();
    }

    app.UseHttpsRedirection(); // 替换原有的app.UseHttps(...)
    app.UseStaticFiles();
    app.UseRouting();
    app.UseAuthorization();

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

常见排查点 #

• 检查证书密码是否正确，避免拼写错误
• 若证书路径仍有问题，可尝试使用绝对路径（例如@"C:\Projects\YourApp\certificate.pfx"）
• 确保自签名证书已导入本地计算机的「受信任根证书颁发机构」，避免浏览器安全警告

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