ASP.NET Core Web API部署至Azure App Service后Swagger页面报500错误求助

以下是本地正常运行但部署后出500错误的核心排查方向：

• 配置与环境变量不匹配
  本地开发依赖appsettings.Development.json，部署到Azure后默认加载appsettings.Production.json，如果生产配置缺少必要项（如连接字符串、服务密钥）或值错误，会直接导致启动失败。另外Azure App Service的「应用设置」里的环境变量会覆盖配置文件内容，需检查是否存在冲突或缺失的变量。

• 部署包不完整
  Visual Studio的自动部署可能遗漏部分依赖（如NuGet包、静态资源、配置文件），或打包过程中文件损坏。建议手动执行dotnet publish -c Release生成发布包，再通过Azure门户上传部署，确保包内包含所有必要文件。

• .NET版本不兼容
  Azure App Service的运行时栈版本需与项目目标框架一致。比如本地用.NET 7，但Azure配置的运行时是.NET 6，会直接导致应用无法启动。可在Azure门户的「配置」->「常规设置」中检查并修改.NET版本。

• 权限不足
  若API需要访问Azure其他服务（如Blob存储、SQL数据库），App Service的托管标识可能没有对应资源的访问权限；或者应用需要写入本地目录（如日志）但文件系统权限不足，都会引发500错误。

• 未启用详细错误日志
  默认情况下Azure不会暴露具体错误信息，需手动开启日志排查：

  1. 在Azure门户进入应用服务的「监视」->「日志流」，启用应用日志和Web服务器日志；
  2. 临时在Program.cs中开启生产环境的详细错误页面（排查完成后记得关闭，避免泄露敏感信息）：

     if (app.Environment.IsProduction())
     {
         // 临时启用以便排查
         app.UseDeveloperExceptionPage();
     }
     

• 端口硬编码问题
  ASP.NET Core在Azure中需监听PORT环境变量指定的端口，而非本地的5000/5001。如果项目硬编码了端口，会导致无法启动。确保Program.cs中使用默认端口配置，不要手动指定端口号：

  var builder = WebApplication.CreateBuilder(args);
  var app = builder.Build();
  

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