【报错问题】 macOS 的安全策略(Gatekeeper)阻止了未签名的原生模块(bcrypt_lib.node)加载

这个错误是由于 macOS 的安全策略(Gatekeeper)阻止了未签名的原生模块(bcrypt_lib.node)加载 导致的。以下是具体解决方案:


1. 临时允许加载未签名模块(推荐先尝试)

在终端运行以下命令,临时解除限制:

bash 复制代码
sudo xattr -r -d com.apple.quarantine /Users/chengchen/Documents/666\ documents/666/666book/server/node_modules/bcrypt/lib/binding/napi-v3/bcrypt_lib.node

此命令会移除 macOS 对该文件的隔离标记(quarantine)。


2. 完全重建 bcrypt 模块

确保编译环境正确后,彻底重新编译:

bash 复制代码
cd /Users/chengchen/Documents/666\ documents/666/666book/server
npm rebuild bcrypt --update-binary

如果失败,尝试强制重新安装:

bash 复制代码
npm uninstall bcrypt
npm install bcrypt --force

3. 检查 Xcode 命令行工具

确保已安装最新版本:

bash 复制代码
xcode-select --install

然后同意许可协议:

bash 复制代码
sudo xcodebuild -license accept

4. 修改 macOS 安全性设置(谨慎操作)

如果上述方法无效,临时放宽安全策略(仅限开发环境):

  1. 打开系统设置 → 隐私与安全性
  2. 在底部找到提示 "已阻止加载 bcrypt_lib.node" ,点击 "仍要允许"
  3. 重启终端后再运行项目。

5. 终极方案:换用 bcryptjs

如果仍无法解决,使用纯 JavaScript 实现的替代库:

bash 复制代码
npm uninstall bcrypt
npm install bcryptjs

然后在代码中将:

javascript 复制代码
const bcrypt = require('bcrypt');

替换为:

javascript 复制代码
const bcrypt = require('bcryptjs');

(两者 API 完全兼容,但 bcryptjs 性能略低)


关键原因说明

  • macOS Gatekeeper 会阻止加载未经验证签名的二进制文件(尤其是从网络下载的)。
  • bcrypt 的预编译二进制文件可能因路径含空格(666 documents)或权限问题被标记为不安全。
  • 解决方案的核心是 让系统信任该文件绕过限制(仅限开发环境)。
相关推荐
皮卡车厘子1 天前
Mac 挂载目录
macos
良逍Ai出海1 天前
在 Windows & macOS 上安装 Claude Code,并使用第三方 Key 的完整教程
windows·macos
热爱生活的五柒1 天前
linux/mac/wsl如何使用claude code,并配置免费的硅基流动API?(官方的需要付费订阅)
linux·运维·macos
胖胖大王叫我来巡山1 天前
mac本地安装DataEase桌面版
macos
奋斗者1号1 天前
OpenClaw 部署方式对比:云端、WSL、Mac 本机、Ubuntu 虚拟机(2026年2月最新主流实践)
linux·ubuntu·macos
玉梅小洋1 天前
Android SDK 安装指南(MacOS 和 Windows)
android·windows·macos·sdk
2501_916007471 天前
没有 Mac 用户如何上架 App Store,IPA生成、证书与描述文件管理、跨平台上传
android·macos·ios·小程序·uni-app·iphone·webview
胖胖大王叫我来巡山1 天前
Mac通过源码安装部署SQLBOT
macos
June bug2 天前
【领域知识】广告全链路测试
macos·objective-c·cocoa
作孽就得先起床2 天前
Xcode设置中文
macos