如何从C++静态库仅保留公开API？解决链接错误问题

问题根源 #

用objcopy --keep-global-symbol裁剪静态库时，只会保留你指定的全局符号，但C++程序依赖的异常处理段（.eh_frame/.eh_frame_hdr）、虚函数表、RTTI信息、静态构造/析构函数等隐式符号或段会被误删，直接导致链接报错和运行时段错误。此外你原链接命令里-llibrary.a是错误写法，-l参数需省略lib前缀和.a后缀，或直接指定库文件路径。

修复现有objcopy方案 #

1. 补充保留必要的符号与段 #

修改objcopy命令，加入异常处理段和API依赖的隐式符号（比如虚表、RTTI）：

# 替换成你的实际 mangled 符号名
objcopy \
  --keep-global-symbol=your_mangled_api1 \
  --keep-global-symbol=your_mangled_api2 \
  --keep-section=.eh_frame \
  --keep-section=.eh_frame_hdr \
  --keep-global-symbol=_ZTIYourApiClass  # 若API是类成员，保留RTTI符号
  --keep-global-symbol=_ZTVYourApiClass  # 保留虚函数表符号
  liblibrary.a liblibrary-trimmed.a
ranlib liblibrary-trimmed.a

2. 先排查依赖符号 #

用nm工具找出API依赖的所有隐式符号，避免遗漏：

nm -C liblibrary.a | grep -E "your_api_name|_ZTI|_ZTV|__cxx_global_var_init"

把输出的符号全部加入--keep-global-symbol列表。

3. 修正链接命令 #

将错误的-llibrary.a改为：

g++ -I $(pwd)/install/include -L$(pwd)/build -o main test_app.cpp -llibrary
# 或者直接指定库文件路径
g++ -I $(pwd)/install/include -o main test_app.cpp $(pwd)/build/liblibrary.a

更可靠的替代裁剪技术 #

1. 编译阶段直接控制符号可见性（推荐） #

如果能重新编译静态库，用gcc的-fvisibility=hidden隐藏所有符号，仅显式导出需要的API：

• 头文件中声明导出API：

#ifdef __GNUC__
#define API_EXPORT __attribute__((visibility("default")))
#else
#define API_EXPORT
#endif

API_EXPORT void your_api1();
API_EXPORT int your_api2(int param);

• 编译源码时添加选项：

g++ -fvisibility=hidden -c source_file.cpp -o source_file.o

• 打包成静态库：

ar rcs liblibrary.a source_file.o ...

这种方式从根源避免符号冗余，无需后续裁剪，也不会误删依赖段。

2. 使用链接脚本裁剪 #

将静态库转为共享库时，用链接脚本指定导出符号：

1. 编写导出脚本export.map：

{
  global:
    your_mangled_api1;
    your_mangled_api2;
  local:
    *;
};

2. 解压静态库并链接为裁剪后的共享库：

ar x liblibrary.a
g++ -shared -fPIC -Wl,--gc-sections -Wl,--version-script=export.map -o liblibrary.so *.o

如果需要静态库，可基于裁剪后的共享库重新生成（但更推荐编译阶段控制）。

3. 使用LLVM工具链替代GNU objcopy #

LLVM的llvm-objcopy对C++符号和段的处理更兼容，替换原命令即可：

llvm-objcopy \
  --keep-global-symbol=your_mangled_api1 \
  --keep-global-symbol=your_mangled_api2 \
  --keep-section=.eh_frame \
  --keep-section=.eh_frame_hdr \
  liblibrary.a liblibrary-trimmed.a
llvm-ranlib liblibrary-trimmed.a

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