Docker容器运行报错：找不到@nestjs-modules/mailer模块及类型声明

问题描述 #

运行Docker容器时，TypeScript报错：

src/modules/mailer/mail-queue.processor.ts:2:31 - error TS2307: Cannot find module '@nestjs-modules/mailer' or its corresponding type declarations.

已在package.json中配置"@nestjs-modules/mailer": "^1.8.1"，导入MailerService和HandlebarsAdapter均出现相同错误，Dockerfile配置如下：

FROM node:16.17.0-buster

RUN mkdir -p /server/node_modules
RUN chown -R node:node /server/node_modules
WORKDIR /server

# Install Dependencies
COPY package.json ./
RUN npm install --force

COPY . .

解决方案 #

1. 修复Docker依赖安装逻辑 #

npm install --force可能跳过依赖正常安装流程，改用更稳定的npm ci（需确保本地已生成package-lock.json），修改Dockerfile的安装步骤：

# 替换原有的RUN npm install --force
RUN npm ci

若必须使用npm install，去掉--force参数，避免强制跳过依赖校验：

RUN npm install

2. 本地验证依赖正常后再构建镜像 #

• 本地执行以下命令清理并重新安装依赖，确认项目能正常编译运行：

  rm -rf node_modules package-lock.json
  npm install
  npm run build
  

• 本地验证通过后再执行Docker构建，避免因本地依赖问题导致镜像内依赖缺失。

3. 检查Docker镜像内的依赖是否存在 #

构建时可添加步骤验证依赖安装状态，修改Dockerfile：

RUN npm ci
# 验证@nestjs-modules/mailer是否存在
RUN ls -la node_modules/@nestjs-modules/

若构建输出无mailer目录，需检查package.json依赖拼写是否正确，或是否因网络问题导致依赖下载失败。

4. 清理Docker构建缓存 #

Docker会缓存旧的构建步骤，可能复用错误依赖，构建时添加--no-cache参数强制重新安装：

docker build --no-cache -t your-image-tag .

5. 确认导入路径正确性 #

对于HandlebarsAdapter，1.8.1版本的正确导入路径为：

import { HandlebarsAdapter } from '@nestjs-modules/mailer/dist/adapters/handlebars.adapter';

确保模块安装完整后，该路径可正常识别。

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