Azure App Service部署Node.js应用时npx执行报错如何解决

Azure App Service 默认用 Oryx 引擎执行部署构建流程，报npm ERR! could not determine executable to run本质就是两个核心原因：

• 构建阶段默认执行npm install --production，仅安装dependencies下的生产依赖，放在devDependencies里的@remix-run/dev、prisma这类带CLI可执行文件的包根本没被安装，npx自然找不到对应执行入口
• 即便依赖安装完成，Oryx构建阶段的PATH变量没有把项目下node_modules/.bin路径加入检索范围，npx遍历不到本地安装的可执行脚本

• 第一步：修改应用配置，让构建阶段安装全量依赖
  进入Azure App Service的「配置」-「应用程序设置」，新增两个配置项，保存后重启实例：
  • 键：SCM_DO_BUILD_DURING_DEPLOYMENT，值：true
  • 键：NPM_CONFIG_PRODUCTION，值：false
    这两个配置的作用是告知Oryx部署时需要执行完整构建流程，且npm安装依赖时不要跳过devDependencies，保证构建阶段需要的remix、prisma等CLI工具会被正常安装到node_modules目录。
• 第二步：修改package.json脚本，绕开npx的路径识别缺陷
  不要在postinstall脚本里写裸的npx命令，直接通过node调用包内的CLI入口文件，完全不依赖PATH变量和npx的解析逻辑，把原来的postinstall脚本改成如下形式：

  {
    "scripts": {
      "postinstall": "node node_modules/@remix-run/dev/dist/cli.js setup node"
    }
  }
  

  如果需要同时执行prisma的客户端生成命令，直接拼接在后面即可：

  {
    "scripts": {
      "postinstall": "node node_modules/@remix-run/dev/dist/cli.js setup node && node node_modules/prisma/build/index.js generate"
    }
  }
  

• 第三步（兜底方案）：如果前两步操作后仍报错，显式指定构建后执行命令
  还是在应用程序设置页面新增配置项：
  • 键：POST_BUILD_COMMAND，值：npm run build && node node_modules/@remix-run/dev/dist/cli.js setup node
    这个配置会覆盖Oryx默认的构建后执行逻辑，强制按照你指定的顺序执行命令。

避坑提示：不要试图在部署流程里全局安装remix、prisma来解决问题，Azure的构建容器是临时环境，全局安装的包不会在后续构建步骤中持久化，只会额外拖慢部署速度。

修改完成后重新触发部署即可，不会再出现找不到可执行文件的报错。

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