Next.js项目使用bcryptjs时出现TypeError：无法读取compare属性求助

出现这个错误的核心原因是bcrypt变量未被正确导入，导致调用compare方法时找不到该属性。以下是具体排查和解决步骤：

• 检查导入方式
  bcryptjs的正确导入方式分两种：

  • CommonJS规范（适用于Node.js环境，比如Next.js的API路由、Server Components）：

    const bcrypt = require('bcryptjs');
    

  • ES模块规范（适用于ES6+环境）：

    import bcrypt from 'bcryptjs';
    

  注意不要使用import { bcrypt } from 'bcryptjs';这种错误的解构导入，这会导致bcrypt变量为undefined。

• 确认依赖安装正确
  执行以下命令重新安装bcryptjs，确保依赖完整：

  npm install bcryptjs
  

  同时检查项目根目录的package.json文件，确认dependencies中存在"bcryptjs": "^2.4.3"条目。

• 调试验证变量
  在调用bcrypt.compare之前添加调试代码，确认bcrypt变量是否正常：

  console.log('bcrypt变量:', bcrypt);
  const passwordsMatch = await bcrypt.compare(password, user.password);
  

  如果控制台输出undefined，说明导入环节存在问题，回到第一步重新检查导入方式。

• Next.js环境适配
  在Next.js 14中：

  • 若在API路由或Server Components中使用，确保使用Node.js兼容的导入方式（CommonJS或ES模块都可，Next.js会自动处理）；
  • 若在Client Components中使用，bcryptjs支持浏览器端运行，只需保证导入方式正确即可。

内容的提问来源于stack exchange，提问作者JoãoGomes