Node.js Azure Functions本地正常，DevOps Pipeline部署失败求助

1. 核对构建产物的路径与完整性 #

• 检查DevOps流水线构建后的dist目录结构是否与本地完全一致：在流水线中添加步骤打印目录树（如ls -R dist或Get-ChildItem -Recurse dist），确认所有函数的.js文件都存在于dist/src/functions/路径下，避免构建脚本（如npm run build）遗漏编译部分函数。
• 验证package.json的main字段"dist/src/functions/*.js"是否与实际文件路径匹配，注意Linux环境下路径区分大小写。

2. 确认host.json的扩展配置 #

• 本地出现EventGrid端点注册日志，说明本地加载了绑定扩展，而流水线部署无该日志，大概率是扩展未正确加载：
  • 检查host.json是否包含扩展包配置：

    "extensionBundle": {
      "id": "Microsoft.Azure.Functions.ExtensionBundle",
      "version": "[3.*, 4.0.0)"
    }
    

  • 若使用单独安装的扩展依赖（而非extensionBundle），确保package.json中已将@azure/functions-eventgrid、@azure/functions-cosmosdb等依赖放在dependencies（而非devDependencies）中，且流水线的npm install未使用--production参数排除必要依赖。

3. 检查DevOps部署任务配置 #

• 确认Azure Functions部署任务（如AzureFunctionApp@1）的package参数指向包含host.json、package.json和dist目录的根目录，而非仅指向dist目录，否则函数运行时无法找到配置文件。
• 若部署任务启用了clean选项，临时关闭该选项测试：开启clean会清空原有文件，若新构建包存在缺失，会直接导致无函数可用。

4. 验证函数文件的导出格式 #

• 确保所有函数文件使用CommonJS规范导出（Azure Functions Node.js默认支持），示例：

  module.exports = async function (context, eventGridEvent) {
    // 函数逻辑
  };
  

• 若使用ES模块（import/export），需在package.json中添加"type": "module"，同时确保构建后的代码无语法错误。

5. 查看Azure门户的日志流 #

• 部署完成后，在Azure门户打开函数应用的日志流，查看运行时加载函数的详细报错（如文件缺失、语法错误、依赖缺失等），这些信息比流水线日志更精准，能定位具体问题。

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