共享类库中扩展IWebHostBuilder时ConfigureKestrel方法找不到的问题及SSL配置求助

这个问题我之前也碰到过，其实核心是扩展方法的命名空间和依赖包没配对，咱们一步步来解决：

一、先解决CS1061错误的根本原因 #

你报错的核心是：ConfigureKestrel作为IWebHostBuilder的扩展方法，并不在Microsoft.AspNetCore.Hosting命名空间下，也不是默认包含在基础依赖包中的。

1. 给类库安装必要的NuGet包

IWebHostBuilder.ConfigureKestrel的扩展方法定义在Microsoft.AspNetCore.Server.Kestrel.Core包中，你的类库项目大概率没引用这个包：

• 打开类库的NuGet包管理器，搜索并安装Microsoft.AspNetCore.Server.Kestrel.Core，注意版本要和你的Web项目的ASP.NET Core版本完全匹配（比如Web项目用.NET 6，就装6.x的包，不要跨大版本）。
• 或者直接在类库的.csproj文件中添加：

<PackageReference Include="Microsoft.AspNetCore.Server.Kestrel.Core" Version="6.0.25" /> <!-- 版本和你的项目保持一致 -->

2. 添加正确的命名空间引用

在你的扩展方法类中，除了现有的using Microsoft.AspNetCore.Hosting;，还要加上：

using Microsoft.AspNetCore.Server.Kestrel;

因为ConfigureKestrel的扩展方法是在这个命名空间下提供的，之前你找错了命名空间~

二、额外的优化建议（避免后续踩坑） #

1. 不要硬编码证书路径和密码

你现在把证书路径和密码写死在代码里，后续换环境或者证书会很麻烦。建议改成从配置文件读取，比如在appsettings.json中添加：

"CertificateSettings": {
  "Path": "/https/LRA.sertificate.pfx",
  "Password": "1234"
}

然后在扩展方法中通过IConfiguration读取：

public static IWebHostBuilder AddApplicationServices(this IWebHostBuilder hosting)
{
    hosting.ConfigureKestrel((context, options) => 
    {
        var certPath = context.Configuration["CertificateSettings:Path"];
        var certPassword = context.Configuration["CertificateSettings:Password"];
        
        options.ListenAnyIP(8081, listenOptions => 
        {
            try 
            {
                listenOptions.UseHttps(certPath, certPassword);
            } 
            catch (Exception ex) 
            {
                Console.WriteLine("HTTPS error: " + ex.Message);
            }
        });
        options.ListenAnyIP(8080);
    });
    return hosting;
}

2. 改用WebApplicationBuilder扩展（.NET 6+推荐）

如果你的项目是.NET 6及以上，官方更推荐用WebApplicationBuilder（也就是Program.cs里的var builder = WebApplication.CreateBuilder(args);），改成针对它的扩展会更贴合现代模板：

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Server.Kestrel;

namespace LRA.Account.Application.Extension;
public static class SslCertificateInjection
{
    public static WebApplicationBuilder AddSslConfiguration(this WebApplicationBuilder builder)
    {
        builder.WebHost.ConfigureKestrel(options => 
        {
            // 这里写你的Kestrel配置逻辑
        });
        return builder;
    }
}

然后在Program.cs里直接用：

var builder = WebApplication.CreateBuilder(args);
builder.AddSslConfiguration();
// 其他配置
var app = builder.Build();

3. 更简洁的Kestrel配置方式

其实完全可以不用写代码，直接在appsettings.json中配置Kestrel，框架会自动读取：

"Kestrel": {
  "Endpoints": {
    "Http": {
      "Url": "http://0.0.0.0:8080"
    },
    "Https": {
      "Url": "https://0.0.0.0:8081",
      "Certificate": {
        "Path": "https/LRA.sertificate.pfx",
        "Password": "1234"
      }
    }
  }
}

这样连扩展方法都不用写，直接删掉相关代码，框架会自动帮你配置HTTP/HTTPS端口和证书，维护起来更简单。

三、最后再检查一遍 #

1. 类库和Web项目的目标框架版本必须一致（比如都是net6.0）
2. 确认安装的NuGet包版本和项目版本匹配
3. 命名空间已经正确引用

按照上面的步骤来，你的错误应该就能解决了~

内容来源于stack exchange