Next.js+TypeScript中bcrypt导入失败，提示找不到bcryptjs模块

核心错误 #

你安装的是bcrypt包，但代码里却导入了bcryptjs——这是导致模块找不到的直接原因。两者是完全不同的包：

• bcrypt是基于C++的原生加密库，性能更高但依赖编译环境
• bcryptjs是纯JavaScript实现的版本，无需编译，兼容性更好

解决方法二选一 #

方法1：改用bcryptjs（Next.js场景更推荐） #

1. 安装bcryptjs及其TypeScript类型声明：

npm install bcryptjs
npm install -D @types/bcryptjs

2. 保持代码中的导入语句不变即可：

import bcrypt from 'bcryptjs';

方法2：继续使用bcrypt #

如果坚持使用原生bcrypt，需要做以下调整：

1. 安装bcrypt对应的TypeScript类型声明：

npm install -D @types/bcrypt

2. 修改代码中的导入语句为：

import bcrypt from 'bcrypt';

3. 注意Next.js环境限制：
   • bcrypt属于原生模块，只能在Server Components、API路由或Server Actions中使用，绝对不能在Client Components里导入
   • 如果仍然出现编译问题，可尝试将tsconfig.json中的moduleResolution临时改为node（不过Next.js 13+官方推荐bundler，优先确保只在服务器端使用该模块）

额外检查点 #

• 安装完成后重启开发服务器或TypeScript语言服务，避免缓存导致的识别延迟
• 确认node_modules目录下存在对应的包和类型声明文件夹（@types/bcrypt或@types/bcryptjs）

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