Azure App Service中WEBSITE_RUN_FROM_PACKAGE外部URL运行失败

• 验证SAS URL有效性

  • 直接在浏览器访问你的Blob SAS完整URL，确认能正常下载zip包。如果无法下载，先排查SAS权限（必须包含读权限）、有效期是否过期，以及存储账户的防火墙/网络限制（比如存储账户仅限VNet访问，但App Service不在允许范围内）。
  • 检查复制SAS URL时是否完整，避免截断签名部分（SAS的签名是长串字符，末尾容易漏复制）。

• 检查zip包结构是否正确

  • 解压zip包，确认应用的入口文件（如ASP.NET的web.config、Node.js的server.js）直接位于zip根目录，不要嵌套在额外的文件夹里（比如把整个项目文件夹打包，导致App Service找不到启动文件）。

• 查看App Service启动日志

  • 登录Azure门户，进入你的App Service，打开日志流查看实时启动错误；或者访问Kudu控制台（https://<你的应用名>.scm.azurewebsites.net），在Debug console > LogFiles目录下查看具体的启动异常日志，日志会明确提示错误原因（如入口文件缺失、运行时不匹配等）。

• 确认App Service运行时匹配

  • 检查App Service的运行时版本是否和你的应用一致，比如你打包的是.NET 7应用，要确保App Service配置的运行时为.NET 7。

• 检查存储账户网络访问规则

  • 如果存储账户开启了防火墙/VNet限制，需将App Service的出站IP地址添加到存储账户的允许列表（App Service的出站IP可在门户“属性”页查看），或者临时设置存储账户为“允许所有网络访问”来测试是否是网络限制导致的问题。

• 确认WEBSITE_RUN_FROM_PACKAGE配置值正确

  • 确保配置的是完整的Blob SAS URL，格式应为：https://<存储账户名>.blob.core.windows.net/<容器名>/<zip文件名>?<SAS签名>，不要仅填写SAS密钥片段。

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