Azure Function App(v4/Node.js) zip部署后无函数显示问题

问题背景 #

• 完成Azure Function App部署后，门户中无任何函数显示
• 通过Kudu确认文件已正确放置在wwwroot目录，但应用文件标签页存在两个文件夹分隔符，推测此为问题诱因
• 已禁用WEBSITE_RUN_FROM_PACKAGE配置，使用的部署命令为：

  az functionapp deployment source config-zip -g <resource-group> -n <app-name> --src ./deploy.zip
  

排查与解决步骤 #

• 修正压缩包目录结构
  双文件夹分隔符大概率是压缩包目录嵌套导致的：比如压缩时把整个项目文件夹打包，而非直接压缩文件夹内的内容。需重新生成压缩包：进入函数项目根目录，直接压缩host.json、各函数文件夹等核心文件，确保解压后内容可直接对应wwwroot的结构。
• 验证函数配置文件
  检查每个函数文件夹内的function.json是否存在且格式合法，重点确认bindings等关键配置无语法错误。也可在Kudu控制台执行func functions list命令，验证CLI能否识别函数——若CLI能识别但门户不显示，大概率是门户缓存问题，等待片刻或刷新页面即可。
• 确认部署配置状态
  进入Function App的「配置→应用设置」，确认WEBSITE_RUN_FROM_PACKAGE已彻底禁用（删除该设置或设为0），避免残留配置干扰部署。同时在「部署中心→日志」查看部署过程是否有解压失败、权限异常等报错。
• 重启应用生效
  完成上述操作后，在Function App概述页点击「重启」按钮，等待应用重启完成后再查看函数列表。

内容的提问来源于stack exchange，提问作者Remo H. Jansen