You need to enable JavaScript to run this app. 经GitHub/Kudu部署的TypeScript Azure函数未在列表显示的问题排查
优惠活动
大模型
产品
解决方案
定价
更多

经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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 02:06:04