.NET 5 Web API发布后运行dll访问端点返回500，如何部署到Windows Server 2019

• 优先开启详细日志定位问题：修改appsettings.json中的日志配置，将Microsoft.AspNetCore节点的日志级别设置为Debug，执行dotnet application.dll时观察控制台输出的500错误栈，90%的运行时异常可直接通过报错栈定位根因，常见原因包括配置缺失、数据库连接失败、静态资源路径不存在、第三方服务调用失败等。
• 检查环境变量依赖：dotnet run --launch-profile CMDLINE会自动加载launchSettings.json中配置的环境变量（包括默认的ASPNETCORE_ENVIRONMENT以及你自定义的其他环境参数），但直接运行发布后的dll不会自动读取launchSettings.json配置，如果你的代码依赖了这类环境变量，就会触发运行时异常。你可以手动指定环境变量测试：Windows系统下先执行set ASPNETCORE_ENVIRONMENT=Development，再运行dll验证接口是否正常。
• 确认Debug版本影响：你当前输出的包都在Debug路径下，Debug版本携带调试符号、开启了调试断言，性能较差且可能存在额外的调试逻辑，正式发布必须使用Release版本的包。

• 执行发布命令时指定Release配置和输出路径，避免使用默认的Debug输出：

  dotnet publish -c Release -o ./publish
  

  命令执行完成后，所有运行需要的文件都会输出到当前目录的publish文件夹中，请将整个publish文件夹打包交给管理员，不要只传递单独的dll文件。
• 发布前校验appsettings.Production.json中的生产配置是否正确：包括数据库连接字符串、跨域规则、第三方服务地址、鉴权密钥等，不要将开发环境的配置带入生产环境。
• 可选独立部署打包：如果希望服务器无需安装.NET 5运行时即可运行，可以添加独立部署参数生成自带运行时的包：

  dotnet publish -c Release -o ./publish -r win-x64 --self-contained true
  

  该包体积更大，但无需服务器额外安装.NET运行环境。

• 运行时校验：如果是框架依赖部署的包，需要确认服务器已安装.NET 5.0 ASP.NET Core 托管捆绑包，不要仅安装SDK，生产环境建议仅安装托管捆绑包即可。
• 端口冲突处理：如果启动时报端口占用，可以手动指定端口启动：

  dotnet application.dll --urls http://0.0.0.0:5000
  

• 网络配置校验：确认服务器防火墙开放了程序监听的端口，否则外部无法正常访问接口。
• 权限校验：确保程序运行的账号对配置文件、上传目录（如有）等路径有读写权限，避免因权限不足触发运行时异常。
• 优先查看控制台报错：运行程序时保留控制台窗口，所有启动报错和运行时异常都会直接打印在控制台，优先根据报错信息定位问题。

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