.NET Core API部署Azure App Service遇404错误求助

核心原因总结 #

出现该问题的核心是Azure DevOps流水线部署过程中，镜像的配置或App Service的运行环境与本地构建推送的场景存在差异，具体可分为以下几点：

1. 环境变量配置缺失或不匹配 #

.NET Core应用依赖ASPNETCORE_URLS、ASPNETCORE_HTTPS_PORT等环境变量处理端口绑定和HTTPS重定向：

• 本地构建运行时，Docker或本地环境会自动传递这些变量，或代码默认配置了正确端口；但流水线构建的镜像可能未正确注入这些变量，导致应用无法识别HTTPS端口，触发日志中的Failed to determine the https port for redirect警告，进而引发路由匹配失败。
• 若流水线部署时设置了ASPNETCORE_ENVIRONMENT=Production，而代码中仅在Development环境启用Swagger，会直接导致Swagger页面404。

2. 流水线构建/部署步骤修改了镜像内容 #

流水线中的额外构建步骤可能无意中修改了应用配置：

• 比如构建过程中覆盖了appsettings.json或启动命令，导致应用未正确加载Swagger路由；或者部署时未设置正确的容器启动参数，使得应用监听端口与App Service的端口映射不匹配。

3. Azure App Service容器配置错误 #

• 流水线部署时可能未正确设置App Service的容器端口，若应用监听的端口（如5000）与App Service配置的容器端口（如80）不一致，请求无法到达应用，导致404。
• App Service的反向代理设置可能未被应用正确识别，导致应用无法获取外部请求的HTTPS端口信息，引发重定向失败。

排查与解决步骤 #

• 对比镜像差异：使用docker inspect命令分别查看本地构建和流水线构建的镜像，对比环境变量、启动命令、文件内容是否一致。
• 检查App Service环境变量：在Azure门户进入App Service的「配置」->「应用程序设置」，确认：
  • ASPNETCORE_URLS设置为http://+:80;https://+:443（或对应应用监听的端口）
  • ASPNETCORE_HTTPS_PORT设置为443
  • ASPNETCORE_ENVIRONMENT符合预期（若需在生产环境启用Swagger，需调整代码或修改该变量）
• 验证Swagger配置：检查Program.cs中的Swagger启用逻辑，确保未被环境限制，示例：

  builder.Services.AddSwaggerGen();
  
  var app = builder.Build();
  
  // 移除环境判断，或根据需求调整判断逻辑
  app.UseSwagger();
  app.UseSwaggerUI(c =>
  {
      c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
  });
  

• 确认容器端口映射：在App Service的「容器设置」中，将容器端口设置为应用监听的端口（如80或5000）。
• 检查流水线日志：查看Azure DevOps流水线的构建、部署日志，确认是否有步骤修改了应用文件或配置，是否存在构建错误。

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