Elastic Beanstalk EC2实例npm install无报错卡顿问题求助

问题定位 #

从dmesg输出的iou-sqp进程长期阻塞日志，结合你在非AWS环境正常、仅AWS Amazon Linux实例出现大包安装卡顿的现象，可确定为npm 10+版本默认启用的io_uring异步IO特性与Amazon Linux 2023内核存在兼容性bug。io_uring在处理复杂依赖树（如express这类大包的多级依赖）时会触发内核锁竞争，导致进程挂起，小包依赖简单则不易触发该问题。

解决方案 #

1. 临时禁用io_uring（单次安装生效） #

执行npm install时添加环境变量强制关闭io_uring：

npm_config_io_uring=false npm install

2. 全局禁用io_uring（永久生效） #

在EC2实例上配置npm全局参数：

npm config set io_uring false

若通过Elastic Beanstalk自动化部署，可在项目根目录的.ebextensions文件夹下创建00_npm_config.config配置文件，内容如下：

commands:
  01_disable_npm_io_uring:
    command: "npm config set io_uring false"

3. 降级npm版本（备选方案） #

npm 9.x及以下版本默认未启用io_uring，可降级到稳定版本规避问题：

npm install -g npm@9.8.1

4. 替换为其他包管理器（长期方案） #

若频繁遇到npm兼容性问题，建议切换到pnpm或yarn，这类工具的异步IO实现更稳定：

# 安装pnpm
npm install -g pnpm
# 使用pnpm安装依赖
pnpm install

Elastic Beanstalk环境中可修改package.json的scripts字段，指定用pnpm执行安装命令。

验证方式 #

执行npm config get io_uring，返回false则说明禁用配置生效，随后重新运行npm install测试express等大包安装是否恢复正常。

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