Azure Function App发布后控制台UI中函数缺失问题求助

核心排查步骤 #

• 确认部署目标准确性
  先通过CLI验证函数是否实际部署成功：

  az functionapp function list -g $AZURE_RG_NAME -n $AZURE_APP_NAME ${SLOT_PARAMETER}
  

  若CLI能列出新函数，说明是Portal UI缓存问题；若CLI也看不到，检查${SLOT_PARAMETER}的格式是否正确（比如部署到槽位时需写成--slot <槽位名称>），避免部署到了非预期的槽位。

• 强制刷新Portal UI
  用Ctrl+F5强制刷新Azure Portal页面，或切换到其他资源后再返回Function App页面，部分情况下UI缓存会导致新函数延迟显示。

• 检查函数加载状态

  1. 进入Function App的「日志流」，查看是否有函数加载失败的报错（比如依赖缺失、function.json格式错误）。
  2. 核对FUNCTIONS_EXTENSION_VERSION应用设置，确保和本地开发环境的运行时版本一致，版本不兼容会导致函数无法注册。

• 验证部署文件完整性
  登录Kudu控制台（https://<你的应用名>.scm.azurewebsites.net），查看site/wwwroot目录下是否存在新函数的文件夹及function.json等核心文件。若文件缺失，检查本地构建产物是否完整，或func publish命令是否有遗漏参数。

• 确保配置生效
  修改WEBSITE_RUN_FROM_PACKAGE后必须重启Function App才能让设置生效，在脚本末尾添加重启命令：

  az functionapp restart -g $AZURE_RG_NAME -n $AZURE_APP_NAME ${SLOT_PARAMETER}
  

调整后的部署脚本示例 #

# 发布函数应用
func azure functionapp publish $AZURE_APP_NAME ${SLOT_PARAMETER} ${FUNCTION_LANGUAGE} --nozip

# 修改运行模式设置
az webapp config appsettings set -g $AZURE_RG_NAME -n $AZURE_APP_NAME ${SLOT_PARAMETER} --settings "WEBSITE_RUN_FROM_PACKAGE=0"

# 重启应用确保配置与函数加载生效
az functionapp restart -g $AZURE_RG_NAME -n $AZURE_APP_NAME ${SLOT_PARAMETER}

对比排查差异 #

将有问题的Function App与正常运行的App做配置对比，重点检查：

• 应用设置中的存储相关配置（如WEBSITE_CONTENTAZUREFILECONNECTIONSTRING）
• 运行时版本与部署方式的匹配性
• 槽位的配置继承规则

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