Azure Functions(Node.js)发布后函数/触发器不可用，本地运行正常求助

1. 检查发布包的文件完整性 #

执行func azure functionapp publish functiontest --dry-run查看待上传的文件列表，确认dist目录下的所有编译后JS文件都被包含。如果dist目录缺失：

• 检查.funcignore文件，确保没有添加dist到忽略列表（默认配置不会排除该目录，若手动添加过需移除）
• 在package.json中添加构建脚本，让发布过程自动完成TS编译：

"scripts": {
  "build": "tsc",
  "start": "func start"
}

之后用func azure functionapp publish functiontest --build触发带构建的发布流程，替代手动编译后发布的方式。

2. 验证Azure函数应用的运行时配置 #

在Azure Portal的函数应用配置→应用设置中，确认以下参数：

• FUNCTIONS_WORKER_RUNTIME设置为node
• FUNCTIONS_EXTENSION_VERSION设置为~4（与本地使用的@azure/functions v4版本匹配）
• Linux环境需确保WEBSITE_NODE_DEFAULT_VERSION为18.x及以上（v4 SDK推荐的Node.js版本）

3. 确认函数注册代码的正确性 #

检查index.ts及编译后的dist/index.js：

• 确保myHandler函数已正确定义并被引用，示例代码如下：

import { app, HttpRequest, HttpResponseInit, InvocationContext } from "@azure/functions";

async function myHandler(request: HttpRequest, context: InvocationContext): Promise<HttpResponseInit> {
  // 业务逻辑实现
  return { body: "请求处理完成" };
}

app.post('myendpoint', { route: 'test/myendpoint', handler: myHandler });

• 本地执行node dist/index.js，检查是否有语法错误或模块缺失的报错。

4. 排查Azure端的部署与运行日志 #

• 进入Azure Portal函数应用的部署中心，查看完整部署日志，确认是否存在编译失败、文件复制异常等问题
• 在函数页面点击同步触发器按钮，手动触发触发器同步操作
• 打开日志流，查看应用启动时的错误信息，比如入口文件找不到、依赖模块缺失等

5. 调整发布命令参数 #

如果函数应用部署在Linux环境，发布时需指定操作系统类型：

func azure functionapp publish functiontest --os-type linux

同时确认当前登录的Azure账号拥有该函数应用的部署权限，且目标应用的资源组与本地配置一致。

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