bcrypt 的 genSalt() 在 Docker 中卡住不返回，通常由原生模块编译异常或 ABI 不兼容导致，重装 bcrypt 可强制重新构建适配当前环境的二进制文件。
bcrypt 的 `gensalt()` 在 docker 中卡住不返回，通常由原生模块编译异常或 abi 不兼容导致，重装 bcrypt 可强制重新构建适配当前环境的二进制文件。
在 NestJS 应用中使用 bcrypt.genSalt() 时，若代码在 Docker 容器内执行到 await bcrypt.genSalt(1) 后完全阻塞（如控制台仅输出 "A"，后续 "B" 和 "C" 永不打印），而本地开发环境运行正常，这几乎可以确定是 bcrypt 原生绑定（native binding）与容器运行时环境不匹配所致。
根本原因在于：bcrypt 依赖 C++ 编写的 node-pre-gyp 预编译二进制文件。当 Docker 构建环境（如基础镜像、Node.js 版本、glibc 版本、CPU 架构）与运行时环境不一致，或安装时缓存了错误平台的二进制包，就会导致 genSalt() 等异步加密函数内部陷入死锁或无限等待——表现为 Promise 永不 resolve，事件循环被阻塞。
✅ 正确解决方案（非临时规避）：
彻底清除并重新安装 bcrypt，确保其在目标容器环境中完成原生模块的重新编译：
# 进入项目根目录（Dockerfile 构建上下文内） npm uninstall bcrypt npm install bcrypt --build-from-source
? 补充说明：--build-from-source 强制跳过预编译包下载，改用 node-gyp 在当前环境中实时编译，从而严格匹配 Node.js v18.17.1、musl/glibc 及 CPU 架构（尤其在 Alpine 镜像中至关重要）。
? Dockerfile 最佳实践建议：
# 使用多阶段构建，避免 dev 依赖污染生产镜像 FROM node:18.17.1-alpine AS builder WORKDIR /app COPY package*.json ./ RUN npm ci --only=production # 注意：若使用 Alpine，推荐改用 bcryptjs（纯 JS 实现）或显式指定 --build-from-source RUN npm install bcrypt --build-from-source FROM node:18.17.1-alpine WORKDIR /app COPY --from=builder /app/node_modules ./node_modules COPY dist ./dist CMD ["node", "dist/main"]
⚠️ 注意事项：
- ❌ 不要仅执行 npm update bcrypt 或 npm install bcrypt@latest —— 这通常复用旧二进制缓存；
- ✅ 在 Docker 构建过程中，确保 node-gyp 所需编译工具链已就绪（Alpine 需 python3, make, g++；Debian/Ubuntu 需 build-essential, python3）；
- ? 替代方案：如对性能要求不高，可切换为纯 JavaScript 实现的 bcryptjs（无需编译，跨平台稳定），但注意其 hash() 默认轮数为 12，需显式指定 saltRounds: 1 以保持行为一致。
重装后验证：启动容器并执行最小测试片段：
import * as bcrypt from 'bcrypt';
console.log('A');
await bcrypt.genSalt(1); // 应快速返回
console.log('B'); // 此行将正常输出
该问题本质是原生模块环境适配失效，而非代码逻辑错误。坚持“在目标环境构建、于目标环境安装”的原则，即可彻底规避此类阻塞问题。
