Docker部署NestJS项目引入AdminJs遇TS2307模块找不到错误求助

常见原因及修复方案 #

1. Docker容器内依赖未正确安装 #

本地node_modules存在不代表容器里也装了，检查你的Dockerfile是否包含完整的依赖安装步骤：

# 先复制依赖清单文件
COPY package*.json ./
# 安装所有依赖（TypeScript类型声明属于dev依赖，必须安装）
RUN npm install
# 再复制项目源码
COPY . .
# 构建项目
RUN npm run build

如果用多阶段构建，确保构建阶段安装了所有dev依赖，生产阶段安装了AdminJS核心依赖。

2. 缺少AdminJS的TypeScript类型声明 #

虽然AdminJS本身自带类型，但部分场景下可能需要单独安装类型包，本地执行：

npm install @types/adminjs --save-dev

之后重新构建Docker镜像，确保这个依赖被安装到容器内。

3. Docker Volume覆盖了容器内的node_modules #

如果docker-compose.yml里挂载了本地目录到容器，比如：

volumes:
  - .:/app

会导致容器内的node_modules被本地目录覆盖，解决方法是添加匿名Volume排除该目录：

volumes:
  - .:/app
  - /app/node_modules

这样容器内的依赖目录会被保留，不受本地目录影响。

4. 使用npm ci但缺少package-lock.json #

如果Docker中用npm ci替代npm install，但本地没生成package-lock.json，会导致依赖安装不完整。先在本地执行npm install生成锁文件，再复制到容器内执行npm ci。

验证流程 #

1. 本地先跑npm install和npm run build，确认本地能正常构建，排除代码本身问题
2. 重新构建镜像：docker-compose build --no-cache，避免缓存坑
3. 启动容器：docker-compose up

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