如何解决Octokit导致Azure TypeScript函数应用崩溃的问题

我最近也碰到过类似的困扰，先跟你同步下我的环境配置（和你的情况匹配度很高），方便咱们对照排查：

我的环境配置 #

• host.json 扩展包版本：

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

• Node.js版本与Bicep配置：
  使用Node.js 20，Bicep中已正确设置应用程序参数：

{
  name: 'FUNCTIONS_EXTENSION_VERSION'
  value: '~4'
}
{
  name: 'WEBSITE_NODE_DEFAULT_VERSION'
  value: '~20'
}

• 云运行时版本：4.103

接下来分享几个我亲测有效的排查和解决步骤：

1. 检查Octokit版本兼容性 #

Node.js 20和Azure Functions Runtime 4.x对部分npm包的版本有兼容性要求，旧版本的Octokit可能存在未适配Node 20的问题。建议你升级到Octokit最新稳定版：

npm install octokit@latest

如果不想直接升级到最新版，可以查看Octokit的版本说明，选择明确标注支持Node.js 20的版本进行安装。

2. 规范依赖部署方式 #

• 本地开发时，使用npm ci替代npm install，确保安装的依赖和package-lock.json完全一致，避免版本差异。
• 部署时，建议让Azure Functions平台自动构建依赖：在.gitignore中添加node_modules/，不要把本地的依赖包推送到仓库，这样Azure会在部署时根据你的package.json重新安装适配云环境的依赖。

3. 开启详细日志定位崩溃原因 #

很多时候崩溃的具体原因藏在日志里，你可以在Azure门户的函数应用中：

• 进入「监测」->「日志」
• 将日志级别设置为Verbose
• 触发导致崩溃的函数请求，查看实时日志，找到具体的错误信息（比如模块缺失、权限不足、运行时语法错误等），这能帮你精准定位问题根源。

4. 确认TypeScript导入与编译配置 #

• 确保Octokit的导入方式符合TypeScript规范：

import { Octokit } from "octokit";

• 检查tsconfig.json中的module配置，建议设置为"CommonJS"（适配Azure Functions Runtime 4.x的默认模块系统）或"ESNext"（如果已经开启ES模块支持），避免因模块系统不兼容导致崩溃。

5. 验证Bicep配置的实际生效情况 #

部署完成后，务必在Azure门户的「配置」->「应用程序设置」中确认：

• FUNCTIONS_EXTENSION_VERSION确实是~4
• WEBSITE_NODE_DEFAULT_VERSION确实是~20
  偶尔会出现部署时配置未正确同步的情况，手动检查能避免很多隐性问题。

内容来源于stack exchange