ASP.NET Zero中运行NSwag的refresh.bat时遇500内部服务器错误

步骤1：手动验证Swagger接口可用性 #

• 启动Strategia.Web.Host项目，在浏览器中直接访问Swagger文档的JSON地址（通常为https://localhost:<端口号>/swagger/v1/swagger.json），确认是否返回500错误。
• 如果浏览器也返回500，说明问题出在Web.Host服务本身，而非NSwag工具。此时查看Web.Host的启动日志，定位具体异常（比如数据库连接失败、配置错误、依赖注入异常等）。

步骤2：检查NSwag配置文件的Swagger URL #

• 打开D:\Nswag upated strategia\src\Strategia.Web.Host\nswag\service.config.nswag文件，找到swaggerGenerator节点下的url属性，确保该地址与Web.Host启动后的Swagger地址完全一致，包括协议（http/https）、端口号和路由路径，避免拼写错误。

步骤3：确保Web.Host处于运行状态 #

• NSwag需要访问正在运行的Web.Host服务的Swagger接口，因此必须先启动Web.Host项目，待服务稳定后再执行nswag/refresh.bat或nswag run命令。

步骤4：验证Web.Host的Swagger配置 #

• 检查Program.cs（或Startup.cs）中的Swagger配置是否完整：
  • 确认已添加Swagger服务：builder.Services.AddSwaggerGen()及相关配置
  • 确认已启用Swagger中间件：app.UseSwagger()和app.UseSwaggerUI()
  • 确认Swagger文档的路由路径与配置文件中的URL匹配

步骤5：检查Web.Host的配置文件 #

• 查看appsettings.json或appsettings.Development.json中的核心配置：
  • 验证数据库连接字符串是否正确
  • 检查Redis、JWT等服务的配置是否有效
  • 确认当前运行环境（Development/Production）对应的配置文件已正确加载

步骤6：清理重建项目 #

• 执行dotnet clean清理Web.Host项目，再运行dotnet build重新编译，排除编译错误或缓存导致的运行时异常。
• 删除已生成的service.proxy.ts文件，避免缓存干扰。

步骤7：更新NSwag版本 #

• 执行npm install -g nswag@latest更新NSwag到最新稳定版，确保与.NET 8版本兼容。

步骤8：查看详细错误日志 #

• 在appsettings.Development.json中设置日志级别为Debug：

  "Logging": {
    "LogLevel": {
      "Default": "Debug",
      "Microsoft.AspNetCore": "Debug"
    }
  }
  

• 重启Web.Host并访问Swagger，查看控制台或日志文件中的详细异常堆栈，精准定位错误根源。

内容的提问来源于stack exchange，提问作者DIBYA RANJAN ROUT