使用CloudShell部署Azure Function遇问题：应用设置被屏蔽且函数未显示

关于警告说明 #

App settings have been redacted. Use 'az webapp/logicapp/functionapp config appsettings list' to view. 是Azure CLI的默认安全提示，用于隐藏敏感配置项，属于正常输出，无需特殊处理，执行提示的命令即可查看完整应用设置。

核心解决步骤 #

• 检查部署包结构
  确保部署zip包的目录结构正确：根目录需包含host.json，每个函数对应独立子目录（内含function.json）。zip包内文件不能嵌套在额外文件夹中，可通过PowerShell命令验证：

  Get-ChildItem -Path .\your-deploy-package.zip -Recurse
  

• 验证部署目标路径
  确认部署命令指向函数App的正确根目录（Windows环境默认site/wwwroot）。使用az functionapp deployment source config-zip时，--src参数需指向正确的zip包路径，避免部署到错误目录导致函数无法加载。

• 查看函数加载日志
  通过日志排查加载失败原因：

  • 门户：进入函数App → 监测 → 日志流
  • CLI执行：

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

  重点关注函数加载时的依赖缺失、权限错误或配置异常信息。

• 确认WEBSITE_RUN_FROM_PACKAGE设置生效

  1. 用命令检查设置状态：

     az functionapp config appsettings list --name <你的函数App名称> --resource-group <你的资源组名称>
     

  2. 若设置未生效或被部署覆盖，重新设置并重启函数App：

     az functionapp config appsettings set --name <你的函数App名称> --resource-group <你的资源组名称> --settings WEBSITE_RUN_FROM_PACKAGE=0
     az functionapp restart --name <你的函数App名称> --resource-group <你的资源组名称>
     

• 同步函数运行时版本
  确保本地开发的函数运行时版本与Azure配置一致（如.NET 8、Python 3.11等）：

  1. 查看当前Azure运行时配置：

     az functionapp config show --name <你的函数App名称> --resource-group <你的资源组名称>
     

  2. 不一致则更新：

     az functionapp config set --name <你的函数App名称> --resource-group <你的资源组名称> --runtime "<运行时>" --runtime-version "<版本号>"
     

• 手动触发函数同步
  强制Azure重新加载部署的函数：

  az functionapp function sync --name <你的函数App名称> --resource-group <你的资源组名称>
  

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