Azure Function App函数UI消失但文件存在，端点返回404求助

排查与修复步骤 #

1. 检查函数元数据文件完整性 #

Python函数的识别依赖每个函数目录下的function.json文件，若该文件缺失、格式错误（如JSON语法错误），会导致宿主无法加载函数：

• 打开Portal中Function App的App Service Editor（Development Tools菜单下），逐一检查./functions/<函数名>目录下是否存在function.json，并验证文件JSON格式是否合法。
• 若新增函数时未生成该文件，或手动修改后出错，可参考其他正常函数的function.json格式修复，或重新创建函数生成正确的元数据文件。

2. 查看宿主启动日志定位错误 #

通过日志可直接获取函数加载失败的具体原因：

• 进入Kudu控制台（https://<你的函数应用名>.scm.azurewebsites.net/），打开Tools > Log Stream，重启函数应用，观察实时日志。
• 重点关注Function not loaded、Error parsing function.json、ModuleNotFoundError这类报错，比如新增函数引用了未在requirements.txt中声明的依赖，需补充依赖后重新安装。

3. 清理缓存与临时文件 #

旧缓存可能干扰函数扫描：

• 在Kudu的Console中执行以下命令清理缓存目录：

  rm -rf D:\home\site\wwwroot\.python_packages
  rm -rf D:\home\site\wwwroot\__pycache__
  

• 清理完成后重启函数应用，让宿主重新扫描所有函数。

4. 验证扩展包与运行时版本 #

即使host.json配置与正常应用一致，也可尝试重置扩展包：

• 修改host.json中extensionBundle的版本为具体稳定版（如"4.15.0"），保存后重启应用，触发扩展包重新下载。
• 确认Portal中Configuration > General settings里的Python运行时版本，与本地开发环境保持一致，版本不匹配可能引发加载异常。

5. 强制同步函数元数据 #

若以上方法无效，通过Azure CLI强制同步函数：

• 登录Azure CLI后执行：

  az functionapp function sync --name <函数应用名称> --resource-group <所属资源组名称>
  

• 该命令会让函数宿主重新扫描wwwroot目录，更新函数元数据。

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