经GitHub/Kudu部署的TypeScript Azure函数未在列表显示的问题排查
故障日志查看路径
- 实时应用日志:进入目标Function App,在侧边栏依次打开「监视」>「日志流」,选择应用程序日志通道,可直接获取函数运行时启动、函数扫描识别阶段的实时输出,快速定位加载失败的具体报错原因。
- Kudu主机日志:打开Function App对应的「高级工具(Kudu)」入口,进入调试控制台的CMD视图,导航到
D:\home\LogFiles\Application\Functions\Host路径,查看主机启动、函数全量扫描过程的留存日志,重点排查函数发现阶段的异常条目。 - 内置诊断结果:在Function App的「诊断并解决问题」模块,调用函数执行日志诊断模板,可自动筛选函数列表加载失败的关联问题,快速匹配常见配置错配场景。
需逐一核查的核心配置项
- 站点目录结构校验:对照Kudu中上传的实际文件路径,确认核心文件位置符合函数运行时的识别规则:
host.json、package.json必须直接位于site/wwwroot根目录下,不可嵌套在子层级文件夹中- 每个函数的对应目录下,必须存在编译完成的可执行
index.js、配置文件function.json,不可仅上传未编译的TypeScript源码
- 运行栈配置校验:进入「配置」>「常规设置」,确认运行栈选择Node.js环境,且版本与本地开发调试时使用的Node版本完全匹配,不可错配为通用Web应用的Node运行配置。
- Kudu构建开关校验:检查应用设置项,确认存在
SCM_DO_BUILD_DURING_DEPLOYMENT=true配置。如果该值为false,Kudu仅会将Git仓库文件原样拷贝到站点目录,不会执行依赖安装、TypeScript编译等构建步骤,最终会因缺少可执行的编译产物,导致运行时无法识别函数。 - 编译路径匹配校验:确认
package.json中的构建脚本、function.json中的scriptFile字段配置路径完全对齐:TypeScript编译输出的产物路径,必须与配置文件中指向的函数入口路径一致,避免路径错位导致的加载失败。 - 依赖安装校验:确认Kudu部署过程中完成了
npm install流程,node_modules目录下的依赖版本与本地开发时的版本匹配,不存在依赖缺失、版本不兼容导致的函数加载异常。
内容的提问来源于stack exchange,提问作者isark
相关产品推荐
相关产品推荐

