Azure Functions Zip包PowerShell自动部署后无函数显示求助

1. 检查Zip包的目录结构 #

VS Code部署会自动对齐Azure Functions的目录要求，手动打包容易出错：

• 确认Zip包根目录直接包含host.json、编译后的dist文件夹，以及每个函数对应的子目录（内有function.json和执行脚本）。
• 错误示例：将整个项目根目录打包（包含src、.git等无关文件），导致Azure无法识别函数入口。正确做法是只打包部署必需文件：dist、host.json、package.json、function.json所在目录。

2. 修正部署命令的参数 #

使用az functionapp deployment source config-zip时，需确保参数完整且配置匹配：

• 核对--resource-group、--name（Function App名称）、--src（Zip文件路径）是否正确。
• 强制指定运行时配置，确保和本地开发环境一致（比如Node.js 18 + Functions v4）：

  az functionapp config set --name <你的FunctionApp名称> --resource-group <资源组名称> --runtime node --runtime-version 18 --functions-version 4
  

3. 处理依赖安装逻辑 #

NestJS部署需要确保依赖正确安装：

• 打包前执行npm ci --only=production，将node_modules纳入Zip包；若希望Azure自动构建，需开启自动构建配置：

  az functionapp config appsettings set --name <你的FunctionApp名称> --resource-group <资源组名称> --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true
  

• 检查package.json的scripts中是否包含build命令，确保Azure能自动编译代码。

4. 查看部署日志定位错误 #

直接从Azure获取部署日志，快速定位问题：

• 登录Azure Portal，进入Function App → 部署中心 → 日志，查看最近部署的错误信息（比如文件缺失、编译失败）。
• 用PowerShell拉取最新部署日志：

  az functionapp log deployment show --name <你的FunctionApp名称> --resource-group <资源组名称> --latest
  

5. 核对NestJS Azure Functions的构建配置 #

若使用@nestjs/azure-func-http，需确保构建输出符合要求：

• 检查nest-cli.json的compilerOptions.outDir是否设为dist，且function.json中的scriptFile路径指向正确的编译文件（比如../dist/main.js，需匹配实际目录结构）。
• 手动部署时VS Code会自动生成正确的function.json，脚本打包时需确保该文件被正确包含在Zip包的对应函数目录下。

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