Azure Function App(Node.js)部署后函数未在门户显示问题排查

本地通过func start能正常运行3个HTTP触发的Azure Functions，但经VS Code或Azure CLI部署后，Azure门户的Functions面板显示“No functions available”，结合你的环境（Core Tools v4.0.6821，Runtime 4.1036.1.23224），可从以下几个方向排查：

可能的原因及解决方法 #

1. 部署包遗漏核心文件 #

• 检查本地项目的.funcignore配置，确认没有误排除函数的function.json、业务代码文件（如index.js/index.ts）。比如如果.funcignore中包含*.js，会直接漏掉所有JS函数代码。
• 修复：编辑.funcignore，仅保留必要的排除项（如node_modules/、.vscode/、local.settings.json），确保函数相关的配置和代码文件都能被打包部署。

2. 运行时版本不匹配 #

• 本地使用的是Core Tools v4（对应Functions Runtime v4），如果Azure函数应用配置的运行时版本为v3或更低，会导致函数无法被识别加载。
• 修复：
  1. 进入Azure门户的目标函数应用
  2. 打开配置 > 常规设置，确认运行时版本设置为~4，同时Node.js版本需与本地开发环境一致（如本地用18.x则选18）
  3. 保存配置后重启函数应用

3. 部署过程存在静默错误 #

• VS Code或Azure CLI部署时可能表面显示成功，但实际存在包上传不完整、解压失败或权限问题。
• 修复：
  • 使用Azure CLI重新部署并查看详细日志：func azure functionapp publish <你的函数应用名称> --verbose，检查日志中是否有文件上传失败、权限不足等提示
  • 到Azure门户的部署中心查看部署历史，确认所有部署记录均为“成功”，若有失败项，点击查看具体错误信息

4. 函数文件夹结构不符合规范 #

• Node.js Azure Functions要求每个函数拥有独立的文件夹，结构示例如下：

  你的函数应用根目录/
  ├── host.json
  ├── Function1/
  │   ├── function.json
  │   └── index.js
  ├── Function2/
  │   ├── function.json
  │   └── index.js
  └── Function3/
      ├── function.json
      └── index.js
  

  若函数文件未放在独立文件夹中，或function.json的name字段与文件夹名差异过大，可能导致识别失败。
• 修复：调整文件夹结构，确保每个函数都有独立目录，function.json的name建议与文件夹名保持一致。

5. 依赖缺失或版本冲突 #

• 本地运行依赖node_modules中的包，但部署时若未完整安装依赖，或远程构建时Node版本不匹配，会导致运行时缺少依赖，函数无法初始化。
• 修复：
  • 本地先执行npm install确保所有依赖安装完成，再执行部署操作
  • 若启用远程构建，需在函数应用的配置 > 常规设置中确认启用远程构建已开启，且Node.js版本与本地一致

6. Host.json配置错误 #

• host.json中的配置语法错误或不兼容（如混用v3和v4的配置结构），会导致Functions Host无法正常加载函数。
• 修复：通过Azure门户的高级工具 > Kudu > 调试控制台，查看部署后的site/wwwroot/host.json内容，与本地能正常运行的版本对比，修正语法错误或不兼容配置。

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