Azure CLI部署Python WebApp超时但实际部署成功的问题求助

针对你遇到的az webapp up命令超时但应用已实际部署完成的问题，可通过以下几种方法稳定CLI的部署状态识别：

1. 配置App Service健康检查路径 #

az webapp up依赖Azure App Service的健康检查状态判断实例是否就绪，默认路径可能无法正确识别FastAPI应用的就绪状态。将健康检查路径指向你已有的/version端点：

az webapp config set --resource-group <rg> --name <webapp-name> --health-check-path /version

配置后，App Service会定期请求/version，只要该端点返回200 OK，CLI就能正确识别实例就绪状态，避免无意义的轮询等待。

2. 调整CLI超时参数 #

如果健康检查配置后仍偶尔出现超时，可手动延长az webapp up的超时时间（默认超时可能偏短），在原命令后添加--timeout参数：

az webapp up --subscription <subscription> --name <webapp-name> --resource-group <rg> --plan <app-service-plan> --runtime PYTHON:3.11 --debug --verbose --launch-browser --location northeurope --timeout 300

这里设置为300秒（5分钟），足够覆盖实例启动的最长耗时。

3. 拆分部署流程，规避az webapp up的轮询逻辑 #

az webapp up是一站式命令，集成了资源创建、代码部署和状态轮询，拆分步骤可避免其内置轮询的bug：

• 先确保WebApp资源已创建（若已存在可跳过）：

  az webapp create --subscription <subscription> --name <webapp-name> --resource-group <rg> --plan <app-service-plan> --runtime PYTHON:3.11 --location northeurope
  

• 单独部署代码：

  az webapp deploy --resource-group <rg> --name <webapp-name> --src-path . --type zip
  

• 手动验证后启动浏览器：
  Windows：start https://<webapp-name>.azurewebsites.net
  Mac/Linux：open https://<webapp-name>.azurewebsites.net

4. 确认端口映射配置 #

FastAPI的uvicorn默认监听8000端口，而Azure App Service默认监听80端口，若未配置端口映射，App Service可能无法检测到实例就绪。添加端口映射配置：

az webapp config appsettings set --resource-group <rg> --name <webapp-name> --settings WEBSITES_PORT=8000

验证方法 #

部署完成后，可通过以下命令快速确认实例状态：

az webapp show --resource-group <rg> --name <webapp-name> --query state

返回Running即说明实例就绪，此时可直接访问应用。

内容的提问来源于stack exchange，提问作者Jesus Diaz Rivero