使用IApplicationBuilder扩展方法时Kestrel无法启动的问题排查

你的代码在中间件实现逻辑上是正确的，Kestrel无法启动大概率是以下常见问题导致，逐一排查即可：

1. 端口被占用 #

Kestrel默认使用5000/5001端口，若这些端口被其他程序占用，会直接导致启动失败。

• 解决方法：
  • 修改Properties/launchSettings.json中的applicationUrl字段，更换为未被占用的端口：

    "applicationUrl": "https://localhost:7200;http://localhost:5200"
    

  • 或者通过命令行启动时指定端口：

    dotnet run --urls "http://localhost:5200"
    

2. 未设置响应内容类型 #

直接调用Response.WriteAsync时若未指定Content-Type，部分环境下会触发Kestrel的响应头校验异常，导致启动失败或响应异常。

• 修改代码添加内容类型设置：
  调整LoginAuthenticatorMiddleware的InvokeAsync方法：

  public async Task InvokeAsync(HttpContext context, RequestDelegate next)
  {
      if (context.Response.ContentType == null)
      {
          context.Response.ContentType = "text/plain; charset=utf-8";
      }
      await context.Response.WriteAsync("Calling LoginAuthenticatorMiddleware\n");
      await next(context);
  }
  

  同时修改Program.cs中的Run委托：

  app.Run(async context =>{
      if (context.Response.ContentType == null)
      {
          context.Response.ContentType = "text/plain; charset=utf-8";
      }
      await context.Response.WriteAsync(" Hi this is the Run method \n");
  });
  

3. 确认中间件注册与扩展方法的正确性 #

虽然你的代码已经满足要求，但再核对以下两点：

• LoginAuthenticatorMiddlewareExtensions必须是静态类，且扩展方法为静态方法（你的代码已符合）
• Program.cs中已正确引用中间件所在的命名空间Esercizio_6.CustomMiddleware（你的代码已添加using语句）

4. 检查项目SDK版本 #

若使用的ASP.NET Core SDK版本过低，可能对IMiddleware接口的支持存在兼容问题。

• 打开项目文件（.csproj），确认TargetFramework为.NET 6及以上版本：

  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
  </PropertyGroup>
  

验证修复 #

完成上述调整后重启项目，访问对应地址，正常情况下会输出：

Calling LoginAuthenticatorMiddleware
 Hi this is the Run method 

内容的提问来源于stack exchange，提问作者Joseph francisco Cubas Ballon