Azure App Service ZIP包部署至槽位后应用无法加载问题求助

针对部署zip包到预演槽后仍显示微软默认页面的问题，可按以下步骤排查解决：

1. 确认zip包结构正确性 #

启用WEBSITE_RUN_FROM_PACKAGE="1"时，App Service会直接从zip包加载应用，因此zip包的根目录需包含应用核心入口文件（如你的xxxx.js），不能嵌套在子文件夹中。若入口文件在子目录，需同步调整启动命令中的路径。

2. 验证启动命令路径准确性 #

检查你设置的启动命令：

az webapp config set --resource-group myapp-rg --name myapp --slot staging --startup-file "pm2 start /home/site/wwwroot/xxxx.js --no-daemon"

需确保：

• xxxx.js的文件名与zip包内实际文件名完全一致（Linux环境区分大小写）
• 若入口文件在zip包子目录中，路径需对应调整（例如/home/site/wwwroot/app/xxxx.js）

3. 查看应用启动日志排查错误 #

通过CLI查看实时日志，确认启动过程中是否存在文件找不到、权限错误等问题：

az webapp log tail --resource-group myapp-rg --name myapp --slot staging

也可在Azure门户的「应用服务」→「日志流」中查看详细报错信息，这是定位启动失败原因最直接的方式。

4. 确保环境变量生效并重启槽位 #

设置WEBSITE_RUN_FROM_PACKAGE后，需重启预演槽使配置生效：

az webapp restart --resource-group myapp-rg --name myapp --slot staging

重启后再次访问预演槽URL，确认是否加载自定义应用。

5. 检查packagetemplate.txt内容 #

验证文件内的内容是否指向正确的zip包文件名。例如，若上传的zip包名为myapp.zip，则packagetemplate.txt内应仅包含该文件名，无多余字符或路径。

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