C# .NET 6本地运行正常，部署后频繁出现502 Bad Gateway问题求助

一、服务器环境配置排查 #

• 确认服务器已安装.NET 6运行时（自包含部署可跳过）：在服务器命令行执行dotnet --version，确保输出6.x版本
• 检查IIS核心配置：
  • 应用程序池的.NET CLR版本设为无托管代码（.NET 6依赖AspNetCoreModuleV2托管，无需传统CLR）
  • 验证AspNetCoreModuleV2已安装：在IIS管理器的「模块」列表中能找到该模块
  • 应用程序池身份权限：确保池身份拥有网站目录、数据库、文件资源的访问权限
• 端口占用检查：若用Kestrel直接部署，确认程序监听端口未被其他服务占用；若用IIS，确认站点绑定端口未被占用且防火墙已开放

二、代码与配置文件排查 #

• 配置文件校验：
  • appsettings.json中数据库连接字符串是否匹配生产环境（服务器地址、账号、数据库名是否正确）
  • 确保日志配置已开启，方便捕获启动或运行时错误
• 代码逻辑检查：
  • 全局异常处理：在Program.cs中添加app.UseExceptionHandler("/Home/Error")（生产环境）或app.UseDeveloperExceptionPage()（开发环境），避免未捕获异常导致进程崩溃
  • 启动依赖检查：排查Program.cs/Startup.cs中是否有服务初始化失败的情况（比如数据库连接失败、第三方服务调用超时），这类问题会直接导致程序启动失败
  • Kestrel监听配置：如果自定义了监听地址，确保服务器防火墙开放对应端口，示例：

    builder.WebHost.ConfigureKestrel(serverOptions =>
    {
        serverOptions.ListenAnyIP(5000); // 开放5000端口
    });
    

三、日志排查（核心步骤） #

• 启用.NET文件日志：在Program.cs中配置日志输出到文件，便于定位启动失败原因：

  builder.Logging.AddFile("logs/app-{Date}.txt");
  

  （需提前安装Serilog.AspNetCore或Microsoft.Extensions.Logging.File NuGet包）
• 查看IIS日志：日志默认路径为C:\inetpub\logs\LogFiles\W3SVC{站点ID}，里面会记录请求的详细错误信息
• 检查Windows事件查看器：打开「Windows日志 -> 应用程序」，查找.NET Runtime或IIS相关的错误事件，里面会包含程序崩溃的具体异常堆栈

四、标准.NET 6 Program.cs示例（替代传统Startup.cs） #

.NET 6推荐使用顶级语句，Startup.cs可合并到Program.cs中，以下是基础示例：

var builder = WebApplication.CreateBuilder(args);

// 添加基础服务
builder.Services.AddControllersWithViews();
// 若使用Razor Pages，替换为 builder.Services.AddRazorPages();

// EF Core数据库配置示例（按需添加）
// builder.Services.AddDbContext<AppDbContext>(options =>
//     options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));

var app = builder.Build();

// 请求管道配置
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

// 路由规则配置
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");
// Razor Pages路由替换为 app.MapRazorPages();

app.Run();

兼容传统Startup.cs结构示例 #

Startup.cs

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

namespace YourAppNamespace
{
    public class Startup
    {
        public Startup(IConfiguration configuration)
        {
            Configuration = configuration;
        }

        public IConfiguration Configuration { get; }

        // 配置服务容器
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddControllersWithViews();
            // 按需添加其他服务，如缓存、第三方SDK等
        }

        // 配置HTTP请求管道
        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }
            else
            {
                app.UseExceptionHandler("/Home/Error");
                app.UseHsts();
            }

            app.UseHttpsRedirection();
            app.UseStaticFiles();

            app.UseRouting();

            app.UseAuthorization();

            app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllerRoute(
                    name: "default",
                    pattern: "{controller=Home}/{action=Index}/{id?}");
            });
        }
    }
}

对应Program.cs

using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Hosting;

namespace YourAppNamespace
{
    public class Program
    {
        public static void Main(string[] args)
        {
            CreateHostBuilder(args).Build().Run();
        }

        public static IHostBuilder CreateHostBuilder(string[] args) =>
            Host.CreateDefaultBuilder(args)
                .ConfigureWebHostDefaults(webBuilder =>
                {
                    webBuilder.UseStartup<Startup>();
                });
    }
}

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