Azure Function部署失败求助：ZIP Deploy失败且包未提取

方法1：手动更新packagename.txt并重启 #

• 登录Kudu控制台：在Azure门户打开目标Function App，进入「开发工具」>「高级工具」>「Go」
• 导航到\data\SitePackages目录，确认新上传的ZIP包文件名
• 编辑packagename.txt，把内容换成新ZIP包的完整名称（比如your-function-v1.0.1.zip）
• 回到Azure门户重启Function App，触发新包加载

方法2：修改应用设置强制刷新部署 #

• 进入Function App的「配置」>「应用程序设置」，找到WEBSITE_RUN_FROM_PACKAGE
• 临时把值改成0，保存后再改回1；或者直接替换成新ZIP包的SAS URL（如果包存在存储账户）
• 保存设置后应用会自动重启，触发部署状态刷新

方法3：用Azure CLI强制重部署 #

• 打开Azure CLI，完成登录和订阅切换：

  az login
  az account set --subscription <你的订阅ID>
  

• 执行带--force参数的ZIP部署命令，强制覆盖旧部署：

  az functionapp deployment source config-zip --resource-group <资源组名> --name <Function App名> --src <本地ZIP路径或远程URL> --force
  

方法4：清理SitePackages目录后重新部署 #

• 登录Kudu控制台，进入\data\SitePackages目录
• 删除所有旧ZIP包，只保留最新上传的那个
• 删除packagename.txt文件
• 重新触发流水线部署，或手动上传ZIP包，系统会自动生成新的packagename.txt并加载新包

流水线优化建议 #

• 在ARM部署步骤后加一个等待应用就绪的步骤，避免包部署时应用状态不稳定：

  - task: AzureCLI@2
    inputs:
      azureSubscription: '<你的服务连接>'
      scriptType: 'bash'
      scriptLocation: 'inlineScript'
      inlineScript: |
        az functionapp wait --resource-group <资源组名> --name <Function App名> --created
  

• 严格保证ARM部署完成后再执行包部署，避免资源未就绪导致部署异常

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