Azure部署Express+Socket.io Node项目时提示无法找到express模块问题咨询

本地环境可正常运行但Azure报Cannot find module 'express'，本质是Azure的运行实例内没有安装项目所需的生产依赖，和项目代码逻辑无关。本地运行时能正常加载express，是因为本地目录下已经通过npm install生成了完整的node_modules依赖目录；部署到Azure时如果没有触发平台的依赖安装流程，或者安装路径、配置不正确，就会因为找不到依赖文件抛出这个关键错误。

• 先校验项目根目录的依赖配置文件完整性
  • 确认项目根目录下存在结构合规的package.json文件，且express、socket.io这类运行必须的包，全部写在dependencies字段下，不要错放到devDependencies分组中——Azure默认部署流程只会自动安装生产环境依赖，devDependencies下的包会被跳过
  • 不要把本地生成的node_modules文件夹直接打包上传到Azure，跨系统的依赖二进制文件不兼容，反而会引发更多运行异常
• 触发并确认Azure的自动依赖安装流程
  • 如果是通过Git、VS Code直连的方式部署项目，Azure默认会在部署完成后自动执行npm install --production，需要确认两个配置项：一是应用服务的根运行路径指向项目实际存放的根目录，不要指向嵌套的子文件夹，导致平台在错误路径下找不到package.json，自然不会触发依赖安装；二是自动安装的开关没有被人为关闭
  • 如果是通过Zip包上传的方式部署，要开启应用服务的“从Zip包运行”配置，平台会在解压完成后自动执行依赖安装；如果自动安装因为网络问题中断，可以通过应用服务内置的Kudu控制台，手动进入项目根目录执行npm install --production，等待所有依赖安装完成
• 校验运行时的工作路径
  • 确认应用服务配置的启动命令和项目实际入口匹配，比如项目入口为server.js时，启动命令设置为node server.js。如果启动命令指向了错误的工作目录，哪怕依赖已经安装在正确路径下，运行时也会因为路径不匹配抛出找不到模块的错误
• 针对WebSocket项目的额外检查
  • 除了express模块，要确认安装完成后，socket.io的依赖文件也完整加载在node_modules目录下，如果安装过程中出现网络超时、拉取中断的情况，会连带出现多个依赖缺失的报错，重新执行一次全量依赖安装即可解决

• 不要直接把本地Windows环境生成的node_modules同步到Azure的Linux运行环境，两者的原生模块编译产物不通用，就算上传了也无法正常加载
• 依赖安装完成后，必须手动重启一次应用服务，让运行进程重新扫描加载所有模块，不然会一直沿用旧的空依赖目录状态
• 如果项目的依赖版本使用了通配符（比如*）声明，安装时可能拉取到和本地运行不兼容的新版本，建议安装完成后锁定依赖版本，避免后续升级引发的运行异常

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