Azure Functions V4（Linux）部署后函数不显示求助

编译与产物验证 #

• 确认本地执行npm run build后，dist目录生成了所有函数的.js编译文件及对应的function.json，Azure Functions仅运行编译后的JS产物，不会处理TS源码。
• 发布前务必完成编译，使用func azure functionapp publish时，默认会触发编译，但如果本地依赖未安装完整，可能导致编译失败，需提前执行npm install。

host.json配置检查 #

• 确保extensionBundle配置匹配V4版本：

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}

• 若使用自定义绑定扩展，需确认Linux环境下已通过func extensions install安装对应扩展，避免依赖缺失导致函数加载失败。

应用服务核心设置 #

• 验证应用设置中的FUNCTIONS_EXTENSION_VERSION为~4，NODE_VERSION与本地开发环境一致（推荐18.x/20.x，符合V4官方支持范围）。
• 设置WEBSITE_RUN_FROM_PACKAGE = 1：针对zip部署场景，该配置让运行时直接从压缩包加载文件，避免Linux环境下的文件权限问题。
• 不要自定义启动命令：Linux版Functions V4会自动处理启动流程，自定义命令可能导致运行时无法正确加载函数。

部署操作细节 #

• 使用func azure functionapp publish时，添加--publish-local-settings参数，将本地local.settings.json中的必要配置（如存储连接字符串）同步到云端。
• zip部署时，压缩包根目录需包含host.json、dist、package.json等核心文件，不能将这些文件放在子目录中，否则运行时无法识别函数结构。
• SCM部署（如CI/CD流程）中，必须包含npm install和npm run build步骤，确保部署的是编译后的产物，而非TS源码。

日志诊断 #

• 进入Azure门户函数应用的监测 > 日志，查看/home/site/wwwroot/logfiles下的文件，寻找函数加载失败的具体错误（如依赖缺失、语法错误）。
• 启用应用服务诊断，运行“函数应用无法启动”诊断工具，自动排查配置、依赖、权限等潜在问题。

V3版本兼容问题（针对过往尝试） #

• V3的JavaScript函数无法触发，需检查function.json中的scriptFile路径是否正确指向编译后的.js文件，绑定配置是否符合V3规范。
• 切换V3/V4版本时，需删除旧的node_modules和扩展包，重新安装对应版本的依赖，避免版本冲突。

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