如何将openssl-sys crate静态链接至共享库？设置环境变量仍失效

我之前也踩过OpenSSL静态链接进Rust共享库的坑，给你几个针对性的排查和解决思路：

1. 确保环境变量在构建时正确生效 #

很多时候问题出在环境变量没传递到构建过程里，别只在终端提前export，直接在构建命令里指定更稳妥：

OPENSSL_STATIC=1 cargo build --release

这样能保证cargo进程确实拿到了这个环境变量，避免会话或者shell配置的干扰。

2. 检查openssl-sys的版本与features #

旧版本的openssl-sys对静态链接的支持可能有bug，先把它升级到最新稳定版。另外，最稳妥的方式是启用vendored特性——这个特性会让openssl-sys从源码编译OpenSSL并完全静态链接，彻底绕开系统库的问题：
在你的Cargo.toml里修改依赖：

[dependencies]
# 替换成你实际使用的版本，建议用最新稳定版
openssl-sys = { version = "0.9", features = ["vendored"] }

如果不想用源码编译的OpenSSL，也可以确保启用static特性：

openssl-sys = { version = "0.9", features = ["static"] }

3. 确认系统安装了OpenSSL静态库 #

如果不用vendored，openssl-sys需要系统里有OpenSSL的静态库文件（libssl.a和libcrypto.a）：

• Debian/Ubuntu系：安装libssl-dev和libssl-static包
• RHEL/CentOS系：安装openssl-devel和openssl-static包
• macOS：可以用Homebrew安装openssl@3，然后通过OPENSSL_ROOT_DIR指定路径：

  OPENSSL_ROOT_DIR=$(brew --prefix openssl@3) OPENSSL_STATIC=1 cargo build --release
  

4. 验证最终库的依赖情况 #

构建完成后，用工具确认依赖是否真的没静态链接：

• 查看动态依赖：

  ldd target/release/liblambda.so
  # 或者用objdump
  objdump -x target/release/liblambda.so | grep NEEDED
  

• 检查是否包含OpenSSL符号（确认静态链接成功）：

  nm target/release/liblambda.so | grep SSL_
  

如果能看到大量SSL_开头的符号，说明静态链接已经生效，只是ldd可能还会显示一些残留，但实际运行时不需要动态库。

5. 排查依赖树中的动态链接干扰 #

有时候其他依赖间接引入了未静态配置的openssl-sys，用下面的命令查看整个依赖树里的openssl-sys配置：

cargo tree -f "{p} {f}" | grep openssl-sys

如果发现某个依赖的openssl-sys没有启用static或vendored，可以通过Cargo的resolver机制强制统一版本和特性，或者给那个依赖也加上静态相关的配置。

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