Azure Function Node应用NPM依赖未解析 部署后无node_modules文件夹

1. 排查部署全链路日志 #

• 拉取VSCode Azure扩展的完整部署输出，定位npm install (functions)任务后的报错信息，常见异常包括依赖版本冲突、私有源不可达、package.json脚本执行错误、网络超时等。
• 登录Azure门户进入对应Function App的部署中心，查看本次部署的官方全量日志，确认post deploy阶段的执行状态与异常点。
• 进入Function App的日志流面板，筛选系统级部署日志，排查是否存在CPU/内存资源耗尽导致任务被挂起的情况。

2. 校验只读运行模式配置 #

你提到的应用只读状态大概率由WEBSITE_RUN_FROM_PACKAGE配置导致：

当应用设置WEBSITE_RUN_FROM_PACKAGE = 1时，运行时会直接挂载部署包作为wwwroot目录，该目录全局只读，服务端执行npm install时无写入权限，必然会执行失败或卡住。
进入Function App配置-应用程序设置页校验该配置，根据需求二选一处理：

• 方案A：删除该配置项，恢复默认的可写部署模式，重新触发部署即可让post deploy的npm install正常写入node_modules到wwwroot目录。
• 方案B：保留该配置，改为本地预构建后部署：在本地项目根目录执行npm install --production + tsc完成依赖安装和TS编译，将生成的node_modules和编译后产物一起打包部署，无需服务端执行post deploy任务。

3. 手动验证npm install执行逻辑 #

如确认未开启只读模式且无明确报错，手动执行任务定位问题：

• 进入Kudu高级工具的Debug Console，切换到site/wwwroot目录，手动执行npm install --production，查看实时输出的报错信息，针对性处理权限不足、依赖下载失败等问题。

4. 调整部署策略跳过服务端构建 #

如果服务端npm install始终无法正常执行，直接关闭服务端post deploy任务：

• 在VSCode设置中找到azureFunctions.postDeployTask配置项，清空其默认值，关闭自动执行npm install的逻辑。
• 本地完成依赖安装、TS编译全流程后，再触发部署即可。

5. 边缘场景校验 #

• 确认Function App运行时栈的Node.js版本与本地开发版本完全一致，版本不兼容会导致npm install静默失败。
• 确认应用服务计划规格满足要求，免费/共享级实例经常出现资源不足导致长时间任务被中断的问题，升级到基础级及以上规格后重试。
• 检查是否配置了VNet访问限制或私有npm源，导致服务端无法访问公网npm registry，如需使用私有源，在项目根目录添加.npmrc配置后重新部署。

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