.NET5 RESTful Web API控制台程序在Windows Server 2016无法启动如何解决

第一步：捕获具体错误信息 #

先通过命令行启动程序避免闪退，获取报错信息：

1. 按下Win+R输入cmd打开命令提示符
2. 执行cd 你的程序所在文件夹路径跳转到程序目录
3. 直接输入程序exe名称回车运行，此时控制台不会自动关闭，可查看完整错误日志定位问题

常见故障原因及修复方案 #

• 运行时版本不匹配
  执行dotnet --list-runtimes查看服务器已安装的.NET运行时版本，确认与本地开发使用的.NET 5 SDK版本兼容。如果本地SDK版本高于服务器运行时版本，卸载服务器现有运行时安装对应版本即可。
• 端口占用
  程序默认绑定的5000/5001端口若被其他服务占用，会直接导致启动失败。可通过netstat -ano | findstr "端口号"查看占用情况，启动时添加参数指定未被占用的端口：
  dotnet 你的程序名称.dll --urls="http://0.0.0.0:自定义端口;https://0.0.0.0:自定义HTTPS端口"
• 依赖缺失
  你代码中使用了NSwag的UseOpenApi、UseSwaggerUi3中间件，若编译时未将相关依赖包完整拷贝到生产环境会触发启动异常。建议使用Release模式重新发布项目，发布时选择「框架依赖」模式并确认所有依赖项都被包含在输出目录中。
• 权限或配置错误
  1. 右键程序所在文件夹，在安全选项卡中给运行程序的用户授予「读取 & 执行」「列出文件夹内容」权限
  2. 检查发布目录下的appsettings.json、appsettings.Production.json配置文件是否存在，配置项（如数据库连接、第三方服务地址）是否符合生产环境要求
• 临时开启异常页定位问题
  你当前代码仅在开发环境开启开发者异常页，可临时注释if (env.IsDevelopment())判断条件，强制生产环境输出详细异常信息，定位问题后再恢复原代码逻辑即可。

附：Startup.cs代码片段 #

public Startup(IConfiguration configuration)
{
    Configuration = configuration;
}

public IConfiguration Configuration { get; }

// This method gets called by the runtime. Use this method to add services to the container.
public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers();
}

// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }

    app.UseHttpsRedirection();

    app.UseRouting();
    app.UseOpenApi();
    app.UseSwaggerUi3();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });
}

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