Azure Function包部署成功后门户无函数显示的问题排查

1. 打包路径错误 #

你的打包命令将azure_function文件夹整体压缩，导致部署后Azure函数应用的wwwroot目录下嵌套了一层azure_function文件夹，而Azure要求host.json、package.json等核心文件直接放在wwwroot根目录才能识别函数。

解决方法：
进入azure_function目录后再执行打包命令：

cd azure_function
zip -r ../azure_function.zip .

2. TypeScript代码未编译 #

本地项目用TypeScript编写，但Azure Functions运行环境需要JavaScript文件。如果打包前未执行编译，或Azure未配置自动编译，会导致函数无法被识别。

解决方法：

• 本地先执行编译命令：

  npm run build
  

• 确认package.json中存在build脚本（比如"build": "tsc"），并在Azure函数应用的「配置→应用程序设置」中添加环境变量BUILD_COMMAND，值设为npm run build。
• 打包时确保包含编译后的输出目录（比如dist，具体看tsconfig.json的outDir配置）。

3. 函数文件不符合Azure识别规则 #

Azure Functions需要函数文件包含触发器装饰器/定义，且结构符合要求：

• 检查acmeWorkerFunctionDevjohn1.ts中是否有正确的触发器代码，比如HTTP触发器示例：

  import { AzureFunction, Context, HttpRequest } from "@azure/functions";
  
  const httpTrigger: AzureFunction = async function (context: Context, req: HttpRequest): Promise<void> {
      context.log('HTTP trigger function processed a request.');
      // 函数逻辑
  };
  
  export default httpTrigger;
  

• 函数文件需直接放在src/functions目录下，或每个函数单独一个子目录（比如src/functions/acmeWorkerFunction/index.ts），避免嵌套过深导致无法扫描。

4. host.json配置问题 #

检查host.json中的相关配置：

• 如果存在"functions": []节点，会限制只加载指定函数，需移除该配置或添加你的函数名。
• 确认watchDirectories配置包含src/functions目录，确保Azure能扫描到函数文件。

5. 验证部署后的文件结构 #

通过Kudu站点（https://<你的函数应用名>.scm.azurewebsites.net）进入wwwroot目录，查看实际文件结构：

• 确认host.json、package.json在根目录。
• 确认编译后的JavaScript文件存在（比如src/functions/acmeWorkerFunctionDevjohn1.js或dist/functions/...）。
• 若结构不符，调整打包方式后重新部署。

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