如何配置/构建外部库以实现可重定位构建？以OpenSSL为例

以OpenSSL为例，该问题同样适用于同类配置/构建的库。为避免不必要的重建（并跟踪上游变更及构建缓存未命中情况），希望以「目标无关」的方式构建OpenSSL——即OpenSSL将与父项目捆绑，且构建时最终安装目标尚未明确。

Configure 接受参数 --prefix（指向安装目标路径）及 --openssldir，二者共同定义了如 openssl.cnf 等文件的目录结构：

--prefix prefix for the OpenSSL installation, which includes the #

directories bin, lib, include, share/man, share/doc/openssl #

This becomes the value of INSTALLTOP in Makefile #

(Default: /usr/local) #

--openssldir OpenSSL data area, such as openssl.cnf, certificates and keys. #

If it's a relative directory, it will be added on the directory #

given with --prefix. #

This becomes the value of OPENSSLDIR in Makefile and in C. #

(Default: PREFIX/ssl) #

遗憾的是（推测出于安全原因），--prefix 必须使用绝对路径。

若不指定 --prefix，构建目录会被编译进最终二进制文件，导致如下错误：

$ openssl req 
Can't open /ci/.cache/bazel/_bazel_ci/c4987ee30ca479718f1c230dbaf68e70/sandbox/processwrapper-sandbox/2/execroot/my_project/bazel-out/k8-fastbuild/bin/external/openssl/openssl.build_tmpdir/openssl/skel/etc/ssl/openssl.cnf for reading, No such file or directory

请问是否有办法让OpenSSL这类库以相对路径搜索文件，或重新配置已构建产物以适配安装时才确定的目录？业内通常如何处理该问题？

1. 构建阶段的相对路径适配 #

• 利用运行时环境变量覆盖硬编码路径：构建OpenSSL时指定--openssldir=./ssl（相对最终二进制所在目录的路径），运行时通过OPENSSL_CONF环境变量直接指定配置文件的相对路径，例如：

  OPENSSL_CONF=./ssl/openssl.cnf openssl req
  

  若是在父项目中调用OpenSSL库，可在程序启动时动态设置该环境变量，或调用OpenSSL的OPENSSL_config()函数手动传入配置文件的相对路径（需基于自身二进制路径计算）。
• 使用占位符前缀构建：构建时指定一个固定的短路径占位符作为--prefix（比如/tmp/openssl），这样硬编码进二进制的路径长度较短，后期更容易替换为目标路径。

2. 构建后修改产物路径 #

• 二进制路径替换工具：
  • Linux下使用patchelf修改动态链接库或二进制中的硬编码路径，例如替换OPENSSLDIR的硬编码值：

    patchelf --replace-string /old/absolute/path/ssl ./ssl/ ./libssl.so.3
    

  • macOS下使用install_name_tool处理动态库的路径依赖，对于硬编码的配置文件路径，可使用字符串替换工具（如sed配合二进制编辑）修改，注意需保证替换前后字符串长度一致，避免破坏二进制结构。
  • 静态链接的二进制不建议用此方法，路径已编译进代码段，修改风险高。

3. 业内通用处理流程 #

• 打包工具的后处理机制：像Bazel、CMake这类构建工具，通常会提供genrule或自定义脚本步骤，在构建完成后批量替换二进制中的硬编码占位路径为部署目标的相对路径或实际绝对路径。
• 父项目封装动态定位：在父项目中封装OpenSSL的调用逻辑，启动时先通过系统调用（如getexecname()、readlink("/proc/self/exe")）获取自身二进制的绝对路径，再计算出配置文件、证书等资源的相对路径，通过OpenSSL的API或环境变量注入正确的路径。
• 标准化捆绑路径约定：将OpenSSL的资源文件（如ssl目录）固定放在与二进制同层级的位置，构建时指定--openssldir=./ssl，部署时保持这个目录结构，无需额外修改，直接运行即可。

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