Nuxt 2应用Zip部署Azure WebApp时出现504网关超时错误

调整服务器端部署超时配置 #

Azure SCM部署站点有独立于CLI的超时限制，你设置的--timeout只是本地客户端超时，服务器端默认阈值可能更短。需要在App Service的应用设置中添加以下环境变量：

• SCM_UPLOAD_TIMEOUT：设置为900（单位秒，对应15分钟，可根据包大小调整）
• SCM_COMMAND_IDLE_TIMEOUT：设置为900，避免部署过程中命令执行超时

优化部署包大小 #

117MB的包包含node_modules和构建产物，传输与解压过程容易触发超时，建议优化部署流程：

• 仅上传源代码（剔除node_modules、.nuxt、dist等目录），让Azure自动完成依赖安装与构建：
  1. 本地删除上述冗余目录
  2. 打包纯源代码为zip后重新上传，Azure会自动识别Nuxt项目并执行yarn install和yarn build
• 启用WEBSITE_RUN_FROM_PACKAGE：将zip包上传至Azure Blob存储，生成SAS URL后设置为该应用变量的值，App Service会直接从包运行，无需解压，大幅缩短部署时间

检查App Service定价层 #

免费层（F1）或基础层（B1/B2/B3）的带宽与资源配额有限，大文件上传易因速度过慢超时。可临时升级至标准层（S1/S2/S3）尝试部署，完成后再按需降级

其他排查方向 #

• 确认WEBSITE_ENABLE_SYNC_UPDATE_SITE设置为true的同时，无其他冲突的部署配置
• 尝试通过Kudu控制台手动上传：访问https://<app>.scm.azurewebsites.net/ZipDeployUI上传zip包，排除CLI本身的问题

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