.NET 6 Web API容器部署Azure后404问题求助

针对你的.NET 6 ASP.NET Web API部署到Azure App Service容器后出现404的问题，可从以下几个方向排查：

• Swagger环境限制问题
  .NET 6默认仅在Development环境启用Swagger组件。本地Visual Studio运行时默认使用Development环境，但Azure App Service默认是Production环境，导致Swagger无法访问。
  解决办法：

  • 临时测试：在Azure App Service的环境变量中添加ASPNETCORE_ENVIRONMENT=Development
  • 生产适配：修改Program.cs，让Swagger在指定环境生效（比如同时允许Production）：

    var app = builder.Build();
    
    // 根据需求调整生效环境，示例为所有环境启用Swagger
    app.UseSwagger();
    app.UseSwaggerUI();
    
    // 也可指定特定环境：
    // if (app.Environment.IsDevelopment() || app.Environment.IsProduction())
    // {
    //     app.UseSwagger();
    //     app.UseSwaggerUI();
    // }
    

• 端口与网络监听配置不匹配

  • 检查Dockerfile中的EXPOSE指令，确保和应用监听的端口一致（.NET 6默认是8080或5000/5001）
  • 在Azure App Service的环境变量中设置WEBSITES_PORT为应用监听的端口，比如8080
  • 强制应用监听所有网卡：在Dockerfile中添加ENV ASPNETCORE_URLS=http://0.0.0.0:8080，避免仅监听localhost导致外部无法访问

• Server Core镜像的启动命令验证
  切换到Server Core镜像后，需确认Dockerfile中的ENTRYPOINT/CMD指令路径正确。比如Visual Studio生成的指令通常为：

  ENTRYPOINT ["dotnet", "YourApi.dll"]
  

  确保该dll在Server Core镜像内的路径无误，没有因镜像切换导致的文件路径偏差。

• 容器启动日志细节排查
  即使日志显示"运行正常"，仍需查看Azure Portal中App Service的「容器日志」，确认应用启动时是否有端口绑定失败、dll缺失等隐性错误，验证应用确实在指定端口上完成监听。

• 根路径404补充检查
  若根路径也返回404，需确认Program.cs中是否配置了根路由（比如app.MapGet("/", () => "API Running");），同时检查API控制器的路由配置是否正确，排除应用未正常初始化路由的可能。

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