MacOS Big Sur下XAMPP安装MongoDB扩展遇usprep.h缺失报错
MacOS Big Sur下XAMPP环境安装MongoDB扩展缺失usprep.h报错解决方案
错误说明
执行/Applications/XAMPP/xamppfiles/bin/pecl install mongodb编译MongoDB扩展时,抛出如下编译错误:
fatal error: 'unicode/usprep.h' file not found #include <unicode/usprep.h> ^~~~~~~~~~~~~~~~~~ 1 error generated. make: *** [src/libmongoc/src/libmongoc/src/mongoc/mongoc-scram.lo] Error 1 ERROR: `make' failed
错误根因
编译MongoDB扩展内置的libmongoc组件时,系统未找到ICU(Unicode国际化组件)库提供的unicode/usprep.h头文件,直接触发编译中断。该问题本质是ICU开发包缺失、或编译流程未正确识别ICU的头文件与库路径导致,和MongoDB扩展本身的代码无关。
操作步骤
- 安装ICU4C开发包
打开终端执行命令:brew install icu4c
Mac系统自带的ICU库版本较低,且默认未开放头文件访问路径给第三方编译流程,必须通过Homebrew安装独立的ICU4C包才能满足编译要求。 - 确认ICU4C的实际安装路径
根据Mac芯片架构不同,Homebrew安装的ICU4C默认路径存在差异:- Intel芯片设备:根路径为
/usr/local/opt/icu4c - Apple Silicon芯片设备:根路径为
/opt/homebrew/opt/icu4c
可执行校验命令确认目标头文件是否存在,避免路径配置错误:
Intel芯片执行:find /usr/local/opt/icu4c -name "usprep.h"
Apple Silicon芯片执行:find /opt/homebrew/opt/icu4c -name "usprep.h"
- Intel芯片设备:根路径为
- 带全依赖路径重新执行pecl安装
在原有安装命令的环境变量配置中,追加ICU的头文件路径与库文件路径,确保编译流程能识别到ICU依赖:- Intel芯片设备执行命令:
sudo C_INCLUDE_PATH=/usr/local/opt/openssl/include:/usr/local/opt/icu4c/include LDFLAGS="-L/usr/local/opt/icu4c/lib" /Applications/XAMPP/xamppfiles/bin/pecl install mongodb- Apple Silicon芯片设备执行命令:
sudo C_INCLUDE_PATH=/usr/local/opt/openssl/include:/opt/homebrew/opt/icu4c/include LDFLAGS="-L/opt/homebrew/opt/icu4c/lib" /Applications/XAMPP/xamppfiles/bin/pecl install mongodb
注意事项
- 不要仅把ICU路径写入shell的全局环境变量配置文件,XAMPP自带的pecl编译流程不会自动读取全局shell环境变量,必须在安装命令前直接指定对应变量才能生效。
- 如果之前多次编译失败有残留缓存,可先执行
/Applications/XAMPP/xamppfiles/bin/pecl clear-cache清理缓存后再重新安装,避免旧版源码包重复触发相同报错。
内容的提问来源于stack exchange,提问作者Yasser Alhazani
相关产品推荐
相关产品推荐

