Azure Function创建及Zip部署异常：wwwroot仅含初始化失败文件

以下是针对该问题的排查和解决步骤：

• 调整WEBSITE_RUN_FROM_PACKAGE配置时序
  WEBSITE_RUN_FROM_PACKAGE是控制函数应用运行包模式的核心变量，若脚本先部署Zip包再设置该变量，会导致初始化阶段无法找到正确的包。正确流程：

  1. 先通过AZ CLI设置变量值为1：

     az functionapp config appsettings set --resource-group <你的资源组名> --name <你的函数应用名> --settings WEBSITE_RUN_FROM_PACKAGE=1
     

  2. 再执行Zip部署命令。若之前手动设置过该变量为Blob存储URL，务必改回1，避免模式冲突。

• 给部署后的初始化留足时间
  首次部署或应用冷启动时，平台需要解压Zip包并初始化运行环境，立刻查看wwwroot会出现错误文件属于正常现象。建议在脚本的部署命令后添加等待逻辑：

  • Windows环境：timeout /t 120（等待2分钟）
  • Linux/macOS环境：sleep 120
    等待后再验证wwwroot内容，重复执行时应用处于暖启动状态，因此内容可能正常显示。

• 检查部署命令的正确性
  确保使用标准AZ CLI Zip部署命令，且路径参数无误：

  az functionapp deployment source config-zip --resource-group <你的资源组名> --name <你的函数应用名> --src <本地Zip包的绝对路径>
  

  若路径包含空格，需用引号包裹（比如"C:\My Function App\deploy.zip"），避免解析错误。

• 再次验证Zip包结构
  手动解压你生成的Zip包，确认根目录直接包含host.json、local.settings.json以及函数文件夹。如果Zip包是把项目文件夹整个打包（核心文件嵌套在子目录下），平台解压后会找不到启动文件，导致初始化失败。需保证结构和VS生成的包完全一致。

• 排查应用状态与日志

  1. 检查应用是否处于运行状态：

     az functionapp show --resource-group <你的资源组名> --name <你的函数应用名> --query state
     

     若返回Stopped，执行启动命令：az functionapp start --resource-group <你的资源组名> --name <你的函数应用名>
  2. 查看实时日志定位具体错误：

     az functionapp log tail --resource-group <你的资源组名> --name <你的函数应用名>
     

     日志会显示初始化失败的具体原因，比如文件缺失、权限问题或依赖加载错误。

• 避免并行操作冲突
  如果脚本同时执行部署和应用设置配置命令，可能存在资源竞争。确保部署命令执行完成后再执行其他配置操作，可在部署命令后添加--wait参数让命令等待执行完成：

  az functionapp deployment source config-zip --resource-group <你的资源组名> --name <你的函数应用名> --src <Zip包路径> --wait
  

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