Azure WebApp部署Docker容器后持续出现应用错误求助

1. 确认容器端口配置 #

Azure WebApp要求容器内应用监听0.0.0.0和指定端口（默认8080，可通过WEBSITES_PORT环境变量修改）：

• 检查Dockerfile中的EXPOSE指令是否匹配应用实际监听端口
• 确认应用启动参数未绑定localhost，必须绑定0.0.0.0才能被外部访问

2. 验证镜像平台兼容性 #

你使用docker buildx构建了多平台镜像，需确保与WebApp运行架构匹配：

• 登录Azure容器注册表（ACR），查看镜像manifest确认架构标签（如linux/amd64）是否正确
• 尝试构建单一平台镜像测试，命令示例：

docker buildx build --platform linux/amd64 -t myregistrybasic.azurecr.io/myapp-api-test:v5-amd64 --push .

用该单一平台镜像重新部署，排除多平台镜像的潜在问题

3. 抓取容器启动详细日志 #

虽然Kudu和SSH无法连接，但可通过Azure Portal开启日志排查：

• 进入WebApp的「监控」->「日志流」，查看实时启动日志，定位容器启动失败的具体原因（如依赖缺失、权限错误、启动命令异常）
• 开启「容器日志」配置，设置日志保留期限，后续可在「日志」菜单查看完整的容器启动报错信息

4. 检查ACR访问权限 #

确保WebApp有权限拉取ACR镜像：

• 为WebApp的系统分配身份或用户分配身份授予ACR的AcrPull角色
• 验证WebApp配置的容器注册表凭证（用户名/密码）是否有效，避免凭证过期或错误

5. 本地模拟Azure运行环境 #

在本地模拟Azure的环境变量和端口映射，测试容器是否正常运行：

docker run -p 8080:8080 -e WEBSITE_HOSTNAME=localhost myregistrybasic.azurecr.io/myapp-api-test:v5

访问http://localhost:8080确认应用是否正常，排除环境变量缺失或启动逻辑依赖本地环境的问题

6. 检查WebApp基础配置 #

• 确认WebApp操作系统为Linux（需与容器类型匹配）
• 检查「配置」->「常规设置」中的启动命令是否正确，若容器有自定义启动脚本，需确保参数完整
• 核对「配置」->「环境变量」，确认所有必要的应用变量（如数据库连接字符串）已配置，避免因缺失变量导致启动失败

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