NestJS+Docker环境下已安装依赖导入后为undefined问题排查

1. ES模块导入规则不匹配 #

bcrypt 为 CommonJS 规范包，未内置 ES 模块默认导出配置。你使用的默认导入写法 import bcrypt from 'bcrypt'，如果 tsconfig.json 中未开启 esModuleInterop 和 allowSyntheticDefaultImports 配置，运行时就会返回 undefined。

解决方案： #

两种方案二选一即可：

• 调整导入写法为命名空间导入：

import * as bcrypt from 'bcrypt';

• 在 tsconfig.json 中新增配置：

{
  "compilerOptions": {
    "esModuleInterop": true,
    "allowSyntheticDefaultImports": true
  }
}

2. 跨平台原生编译文件不兼容 #

bcrypt 包含需要根据运行环境编译的原生C++代码。如果你本地开发时会将本地 node_modules 目录挂载到 Docker 容器内，本地（Windows/macOS等非Linux环境）编译生成的 bcrypt 二进制文件无法在alpine镜像中正常运行，即使容器内单独执行过npm install也会被挂载的本地文件覆盖。

解决方案： #

• 在Docker运行配置中排除node_modules目录的挂载，让容器使用自身安装的依赖
• 替换为无原生编译依赖的纯JS实现包bcryptjs，接口和bcrypt完全一致，无需修改业务代码

3. alpine镜像缺少编译依赖 #

alpine为极简发行版，默认缺少bcrypt编译需要的基础依赖，若安装阶段未提前安装会导致bcrypt编译失败，虽然node_modules目录下存在对应包文件夹，但实际可执行文件无效。

解决方案： #

修改Dockerfile，在执行npm install前提前安装编译依赖：

FROM node:12-alpine
ENV NODE_ENV development
# 新增依赖安装步骤
RUN apk add --no-cache make gcc g++ python3
RUN mkdir -p /usr/src/app
WORKDIR /usr/src/app
COPY package.json package-lock.json /usr/src/app/
RUN npm install
COPY . .
ENTRYPOINT ["npm", "run", "start:dev"]

内容的提问来源于stack exchange，提问作者Juan Pedro Pont Vergés