使用ZIP部署Azure Functions后函数未显示的问题求助

以下是几种常见的原因及排查方向：

• ZIP包目录结构不符合规范
  Azure Functions要求代码包结构必须匹配对应运行时规则：

  • 脚本类语言（Python、JavaScript）：每个函数需为独立子目录，目录内包含function.json和入口文件（如__init__.py、index.js），且这些子目录需直接放在ZIP包根目录下；
  • 编译类语言（C#）：根目录需包含bin文件夹（存放编译后的程序集）以及各函数的子目录。
    若代码嵌套在多层子文件夹中，平台无法识别函数定义，自然不会在页面显示。

• 运行时版本不兼容
  创建Function App时指定的运行时版本（如Python 3.10、Node.js 20）与代码开发依赖的版本不匹配，会导致运行时无法加载函数。可在门户「配置>常规设置」中查看FUNCTIONS_EXTENSION_VERSION和运行时版本，确认与本地开发环境一致。

• 部署命令中的应用名称拼写错误
  你执行的命令里应用名称是my-funcation-app（存在拼写错误：funcation应为function），请检查是否与门户中实际创建的Function App名称完全一致。若名称写错，部署操作可能指向了另一个应用（甚至自动创建了拼写错误的同名应用），导致你查看的目标应用无函数。

• function.json文件存在语法或配置错误
  若function.json有JSON语法错误（如缺少逗号、引号不匹配），或触发器配置错误（如type字段值无效、绑定路径错误），平台无法解析识别该函数。可通过Kudu高级工具（门户>高级工具>Go）进入site/wwwroot目录，找到对应的function.json检查格式和配置。

• 平台未自动触发函数扫描
  偶尔会出现部署成功后，平台未自动扫描函数定义的情况。可在Function App「概述」页点击「重启」按钮，让运行时重新扫描并加载函数。

• 文件权限问题（Linux环境）
  若为Linux部署的Function App，ZIP包中的脚本文件可能缺少执行权限，导致运行时无法读取。可通过Kudu终端执行chmod +x <你的入口文件>修改权限，之后重启应用。

内容的提问来源于stack exchange，提问作者Container-Man