ASP.NET Core Web API启动URL异常及Swagger无法访问求助

1. 确认启动配置未被误选 #

• 运行API时，检查VS顶部启动下拉框是否选中了launchsettings.json里定义的项目配置（而非IIS Express或临时配置）；用命令行启动时必须显式指定启动配置，否则会随机分配端口：

  dotnet run --launch-profile "你的项目配置名"
  

2. 清理项目缓存与重建 #

• 执行命令清除临时文件并重新还原依赖：

  dotnet clean
  dotnet restore
  

• 手动删除项目根目录下的bin和obj文件夹，再重新生成项目——EF更新数据库后，生成的配置文件可能未同步更新。

3. 核对launchsettings.json关键配置 #

• 确保applicationUrl格式正确，多地址用逗号分隔：

  "applicationUrl": "https://0.0.0.0:7118;http://0.0.0.0:5118"
  

• 检查launchUrl是否设置为Swagger路径："launchUrl": "swagger"，避免手动输错地址；同时确认environmentVariables里的ASPNETCORE_ENVIRONMENT为Development（生产环境默认不启用Swagger）。

4. 排查端口占用与Kestrel硬编码 #

• 用命令检查7118端口是否被占用：

  netstat -ano | findstr :7118
  

  若被占用，杀掉对应进程或修改launchsettings端口。
• 检查Program.cs/Startup.cs是否有Kestrel硬编码配置，这类代码会覆盖launchsettings：

  builder.WebHost.ConfigureKestrel(options =>
  {
      options.ListenAnyIP(54854); // 此处硬编码会强制使用该端口
  });
  

  如有，修改为目标端口或移除硬编码。

5. Swagger 404专项排查 #

• 确认Program.cs中正确注册并启用Swagger中间件：

  // 注册Swagger服务
  builder.Services.AddSwaggerGen();
  
  // 启用Swagger中间件（需放在UseRouting之后、UseAuthorization之前）
  app.UseSwagger();
  app.UseSwaggerUI();
  

• 若API有自定义路由前缀，需在Swagger配置中对应调整：

  app.UseSwaggerUI(c =>
  {
      c.SwaggerEndpoint("/swagger/v1/swagger.json", "你的API名称 V1");
      c.RoutePrefix = string.Empty; // 若要让Swagger在根路径访问
  });
  

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