Intel芯片MacOS Monterey编译gRPC静态库遇OpenSSL链接错误求助

一、错误核心原因 #

你遇到的X509_STORE_new、BIO_new_mem_buf等符号未定义问题，本质是三个关键矛盾：

1. 版本兼容问题：gRPC v1.22.x是2019年的旧版本，官方仅支持OpenSSL 1.0.x/1.1.x系列，完全不兼容你当前使用的OpenSSL 3.0.5（API存在重大变更）。
2. 架构不匹配：本地MacOS安装的OpenSSL是x86_64架构的，而Android交叉编译需要对应ARM/x86架构的静态库，直接引用本地库必然导致链接失败。
3. CMake配置缺失：默认情况下CMake可能优先查找动态库，且未明确指定交叉编译后的OpenSSL路径，导致链接时无法找到正确的静态符号。

二、针对性解决步骤 #

1. 降级OpenSSL并交叉编译Android静态版本 #

首先需要为Android目标架构编译静态版OpenSSL 1.1.1系列（推荐1.1.1w，是该分支的最后稳定版）：

步骤1：下载OpenSSL 1.1.1w源码

wget https://www.openssl.org/source/openssl-1.1.1w.tar.gz
tar -xzf openssl-1.1.1w.tar.gz
cd openssl-1.1.1w

步骤2：配置交叉编译环境（以arm64-v8a为例）

# 替换为你的NDK实际路径
export ANDROID_NDK=/Users/xxx/Library/Android/sdk/ndk/21.4.7075529
export TOOLCHAIN=$ANDROID_NDK/toolchains/llvm/prebuilt/darwin-x86_64
export TARGET=aarch64-linux-android
# 最低支持Android版本，按需调整
export API=21

# 配置交叉编译工具链
export AR=$TOOLCHAIN/bin/llvm-ar
export CC=$TOOLCHAIN/bin/$TARGET$API-clang
export AS=$CC
export CXX=$TOOLCHAIN/bin/$TARGET$API-clang++
export LD=$TOOLCHAIN/bin/ld
export RANLIB=$TOOLCHAIN/bin/llvm-ranlib
export STRIP=$TOOLCHAIN/bin/llvm-strip

# 配置静态编译并指定输出路径
./Configure android-arm64 no-shared --prefix=/Users/xxx/output/openssl-arm64-static

步骤3：编译并安装

make -j$(sysctl -n hw.ncpu)
make install

2. 重新配置gRPC交叉编译CMake参数 #

先确保gRPC子模块同步完整（切换分支后必须执行）：

git clone https://github.com/grpc/grpc.git
cd grpc
git checkout v1.22.x
git submodule update --init --recursive

创建build目录并执行CMake配置（替换路径为你的实际路径）：

mkdir build-android && cd build-android
export ANDROID_NDK=/Users/xxx/Library/Android/sdk/ndk/21.4.7075529

cmake ../ \
  -DCMAKE_TOOLCHAIN_FILE=$ANDROID_NDK/build/cmake/android.toolchain.cmake \
  -DANDROID_ABI=arm64-v8a \
  -DANDROID_PLATFORM=android-21 \
  # 强制生成静态库
  -DBUILD_SHARED_LIBS=OFF \
  # 指定交叉编译的OpenSSL路径
  -DOPENSSL_ROOT_DIR=/Users/xxx/output/openssl-arm64-static \
  -DOPENSSL_INCLUDE_DIR=/Users/xxx/output/openssl-arm64-static/include \
  -DOPENSSL_CRYPTO_LIBRARY=/Users/xxx/output/openssl-arm64-static/lib/libcrypto.a \
  -DOPENSSL_SSL_LIBRARY=/Users/xxx/output/openssl-arm64-static/lib/libssl.a \
  -DCMAKE_BUILD_TYPE=Release \
  # 关闭测试编译加速构建
  -DgRPC_BUILD_TESTS=OFF \
  # 强制使用指定的OpenSSL，而非gRPC自带子模块
  -DgRPC_SSL_PROVIDER=package

最后执行编译：

cmake --build . -j$(sysctl -n hw.ncpu)

三、MacOS本地编译gRPC静态库的简化步骤 #

如果不需要Android版本，仅编译MacOS x86_64静态库，步骤更简洁：

1. 同步gRPC代码及子模块：

git clone --recurse-submodules https://github.com/grpc/grpc.git
cd grpc
git checkout v1.22.x

2. 配置CMake生成静态库：

mkdir build-macos && cd build-macos
cmake ../ \
  -DBUILD_SHARED_LIBS=OFF \
  -DCMAKE_BUILD_TYPE=Release \
  -DOPENSSL_ROOT_DIR=/usr/local/opt/openssl@1.1 \
  -DgRPC_BUILD_TESTS=OFF

3. 编译并安装（可选）：

cmake --build . -j$(sysctl -n hw.ncpu)
# 安装到系统目录（需sudo权限）
sudo cmake --install .

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