Elastic Beanstalk部署Node.js项目报错：Recreating Dir失败

阿华AIGC实验室

2026-5-8

解决Elastic Beanstalk部署Node.js时的"directory not empty"错误

我来帮你搞定这个部署报错——你遇到的是Elastic Beanstalk在清理 staging 目录时，因为嵌套的node_modules目录非空导致的删除失败问题。具体来说，就是/var/app/staging/node_modules/@gryffindor/beacon-service/node_modules这个子目录里还有文件，EB的默认清理脚本没法直接删掉非空目录。

问题根源

这种情况大多是因为项目里出现了嵌套依赖（也就是大家常说的依赖地狱），本地安装依赖时生成了多层嵌套的node_modules，部署到EB时，EB的部署脚本尝试重建目录但没法递归清理这些非空子目录，就抛出了这个错误。

可行的解决方法

下面按优先级给你几个方案，你可以根据自己的情况选择：

1. 本地清理依赖，重新生成扁平化结构（最推荐）

先从本地解决依赖嵌套的问题，这是根治的办法：

删掉本地的node_modules和锁文件：
```
rm -rf node_modules package-lock.json
```
重新安装依赖，npm现在默认会扁平化依赖结构，尽量避免嵌套：
```
npm install
```
把更新后的package-lock.json提交到版本库，然后重新部署到EB。

2. 给EB加自定义脚本，强制递归清理目录

如果因为某些原因没法避免依赖嵌套，那就让EB在部署前先强制删掉整个staging的node_modules：

在项目根目录新建.ebextensions文件夹（没有的话就创建）。
在里面新建00_clean_staging_node_modules.config文件，内容如下：
```
container_commands:
  01_force_clean_node_modules:
    command: "rm -rf /var/app/staging/node_modules || true"
    leader_only: false
```
这个命令会在EB的默认部署流程启动前，递归删除整个staging下的node_modules，不管里面有没有内容，这样后续的部署步骤就能顺利重建目录了。

3. 改用`npm ci`安装依赖

npm ci会严格按照锁文件的结构安装依赖，不会产生额外的嵌套，能有效避免这类问题：

创建.ebextensions/01_use_npm_ci.config文件：
```
commands:
  01_replace_npm_install:
    command: echo "npm ci" > /opt/elasticbeanstalk/hooks/appdeploy/pre/50npm.sh
    leader_only: false
```
这个配置会替换EB默认的npm install命令为npm ci，保证服务器上的依赖结构和本地完全一致。