单Azure Function App多函数部署异常：本地正常云端无函数显示

问题根源 #

Azure Functions Node.js V4运行时不支持在package.json的main字段中使用通配符（比如*.js），本地调试工具（func CLI）做了兼容所以能正常识别，但云端运行时无法解析这种配置，导致找不到函数。

正确配置方案 #

方案1：使用标准多函数目录结构（推荐） #

这是V4模型的官方推荐结构，无需指定通配符，云端会自动扫描函数：

• 移除package.json中main字段的通配符配置，要么删除该字段，要么设置为包含所有函数文件夹的父目录：

  {
    "main": "./src/functions"
  }
  

• 将每个函数放在独立的文件夹中，每个文件夹包含index.js（函数逻辑）和function.json（触发器配置），比如：

  src/
    functions/
      function1/
        index.js
        function.json
      function2/
        index.js
        function.json
  

• 每个函数的index.js通过app对象注册触发器，比如：

  const { app } = require('@azure/functions');
  
  app.http('function1', {
    methods: ['GET'],
    authLevel: 'anonymous',
    handler: async (request) => {
      return { body: 'Hello from function1' };
    }
  });
  

方案2：单文件注册多函数 #

如果你的两个函数写在同一个文件里，直接指定该文件为main即可：

• 在package.json中设置明确的文件路径：

  {
    "main": "./src/functions/all-functions.js"
  }
  

• 在all-functions.js中注册多个函数：

  const { app } = require('@azure/functions');
  
  // 注册第一个函数
  app.http('function1', {
    methods: ['GET'],
    authLevel: 'anonymous',
    handler: async (request) => {
      return { body: 'Hello from function1' };
    }
  });
  
  // 注册第二个函数
  app.http('function2', {
    methods: ['POST'],
    authLevel: 'anonymous',
    handler: async (request) => {
      return { body: 'Hello from function2' };
    }
  });
  

部署后排查步骤 #

• 登录Azure Portal，进入你的Function App，打开高级工具(Kudu)，进入site/wwwroot目录，确认文件结构和本地一致，函数文件、配置文件都已上传。
• 查看监控->日志流，检查是否有函数加载时的错误日志（比如文件路径错误、语法错误），这些日志能帮你定位具体问题。
• 确认云端Function App的运行时版本为Node.js 20 + Functions V4，在配置->常规设置中可查看和修改。

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