TypeScript Azure Function部署成功但未在函数应用中注册的问题求助

• 检查编译文件与函数配置
  确认每个函数目录下的function.json中，scriptFile路径指向的是编译后的JavaScript文件（比如../dist/functions/xxx.js），而非原TypeScript文件。同时确保function.json格式无语法错误，字段完整。

• 验证运行时配置
  登录Azure控制台，进入函数应用的配置 -> 应用程序设置：

  • 确认FUNCTIONS_WORKER_RUNTIME设为node
  • 检查NODE_VERSION与项目依赖的Node版本匹配（如18.x、20.x）
  • 确保FUNCTIONS_EXTENSION_VERSION设置为兼容版本（如~4）

• 修正单体仓库部署路径

  • 执行func publish时，必须在函数项目根目录操作，或者用--project参数指定路径：

    func azure functionapp publish myFunctionApp --project ./path/to/your-function-root
    

  • 使用zip部署时，确保压缩包的根目录就是函数项目根目录（解压后直接看到host.json、dist等文件），不要包含单体仓库的上层目录。

• 查看日志定位问题
  打开Azure控制台的函数应用日志流，重新部署后观察是否有函数加载失败的报错（比如文件找不到、运行时错误）；也可以查看home/site/wwwroot/logfiles下的日志文件，获取详细错误信息。

• 触发函数重新扫描

  • 调用Rest API触发扫描：发送POST请求到https://<your-function-app-name>.azurewebsites.net/admin/functions/synctriggers?code=<your-master-key>（master-key在函数应用的密钥页面获取）
  • 或者在配置中修改任意一个应用设置并保存，触发应用重启，重启后会自动重新扫描函数。

• 检查部署命令输出
  重新执行func azure functionapp publish myFunctionApp，留意输出中是否有Skipping unknown function directory或No functions found in the project这类提示，以此定位问题。

内容的提问来源于stack exchange，提问作者jones-chris