Azure Function通过Azure Pipeline部署失败：502 Bad Gateway错误排查

核心原因 #

你的本地文件夹结构不符合Azure Functions的部署规范：

• Azure Functions默认要求函数代码文件需放在根目录下的独立函数文件夹中（而非src/function子目录）
• 部署包中未正确包含host.json、package.json与函数代码的对应路径关系，导致App Service无法识别函数入口，引发502网关错误；405警告是函数端点无法被正常解析的衍生问题

解决步骤 #

1. 调整本地文件夹结构 #

将函数代码移动到根目录的独立文件夹中，标准结构如下：

root/
├── host.json
├── package.json
├── node_modules/
└── helloWorld/
    └── helloWorld.js

• 确保每个函数对应一个单独的子文件夹（如helloWorld），函数文件（helloWorld.js）放在该子文件夹内
• host.json和package.json必须位于根目录

2. 修正Pipeline打包逻辑 #

• 使用azure-functions-core-tools的func pack命令在根目录执行打包，自动生成符合要求的部署包：

  - script: |
      func pack --output ./package
    displayName: 'Package Function App'
  

• 若使用自定义zip打包，需确保打包范围是根目录下的所有文件（包括host.json、package.json、函数文件夹），避免仅打包src目录

3. 验证Azure Function App配置 #

• 在Azure Portal中进入你的Function App，检查配置 > 应用程序设置：
  • 确认FUNCTIONS_WORKER_RUNTIME设置为node
  • 确认FUNCTIONS_EXTENSION_VERSION设置为~4（与本地azure-functions-core-tools v4.x版本匹配）
  • 若使用包部署，WEBSITE_RUN_FROM_PACKAGE需配置正确（可通过Pipeline自动设置）

4. 消除405警告 #

• 部署成功后，测试函数端点时需匹配函数代码中定义的HTTP方法（例如函数若为GET触发，需用GET请求访问）
• 检查helloWorld.js中的路由配置，确保未错误限制请求方法

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