.NET 7升级至.NET 8后Azure Linux Web应用启动失败求助

1. 确认.NET 8运行时部署正确性 #

• 检查Azure Web App的运行栈设置：确保已选中.NET 8 (LTS)且操作系统为Linux。若使用自定义容器，需确认镜像内包含.NET 8运行时（自包含部署则无需）。
• 自包含部署时，发布命令需指定Linux目标运行时：

  dotnet publish -c Release -r linux-x64 --self-contained true
  

2. 检查应用监听端口配置 #

• 确认代码未硬编码端口，且监听地址为0.0.0.0（仅监听localhost会导致容器外部无法访问），示例配置：

  var builder = WebApplication.CreateBuilder(args);
  var app = builder.Build();
  app.Run($"http://0.0.0.0:{Environment.GetEnvironmentVariable("PORT") ?? "8080"}");
  

• .NET 8默认读取PORT环境变量，需确保代码逻辑未覆盖该配置。

3. 获取容器启动详细错误日志 #

• 通过Azure门户高级工具 > Kudu > 调试控制台 > 容器查看完整启动日志，或用Azure CLI拉取实时日志：

  az webapp log tail --name octufit-api-dev --resource-group <你的资源组名称>
  

• 重点排查容器退出前的异常：比如运行时初始化失败、依赖缺失、配置文件格式错误等。

4. 验证容器启动命令与槽位配置 #

• 若使用自定义容器，确认启动命令正确（默认ASP.NET Core应用Azure会自动执行dotnet <应用程序集.dll>）；若有自定义启动脚本，需确保脚本正确加载端口并启动应用。
• 若使用部署槽位，检查槽位的应用设置、运行栈是否与生产槽完全一致。

5. 调整HTTP探测配置 #

• 暂时禁用启动探测和存活探测（Azure门户>配置>常规设置），测试应用是否能启动，以此判断是否是探测路径问题（比如默认探测路径/需要授权，导致探测失败）。
• 确认容器设置中的端口映射为8080，与PORT、WEBSITES_PORT配置一致。

6. 本地模拟Linux环境测试 #

• 用Docker构建本地.NET 8容器，模拟Azure环境验证应用可用性，示例Dockerfile：

  FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
  WORKDIR /app
  EXPOSE 8080
  ENV PORT=8080
  
  FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
  WORKDIR /src
  COPY ["OctufitApi.csproj", "."]
  RUN dotnet restore "./OctufitApi.csproj"
  COPY . .
  RUN dotnet build "OctufitApi.csproj" -c Release -o /app/build
  
  FROM build AS publish
  RUN dotnet publish "OctufitApi.csproj" -c Release -o /app/publish /p:UseAppHost=false
  
  FROM base AS final
  WORKDIR /app
  COPY --from=publish /app/publish .
  ENTRYPOINT ["dotnet", "OctufitApi.dll"]
  

• 构建运行后测试http://localhost:8080，若本地也无法启动，说明应用本身存在问题。

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