基于libtool配置实现Linux共享库向后兼容的版本控制问题

问题根因说明 #

你之前的配置仅能保证ABI向后兼容，无法触发加载阶段的版本校验：Linux动态链接器默认只校验SONAME主版本号（由version-info的current - age计算得出），同主版本号的库会被直接加载，且符号默认采用惰性解析策略，只有实际调用到不存在的符号才会触发报错。

正确实现方案 #

方案一：符号版本控制（推荐） #

该方案无需改动SONAME主版本，可精准控制版本校验逻辑，无额外性能损耗。

1. 保留正确的version-info配置

因为你完全向后兼容新增API/ABI，没有修改或删除原有接口，version-info设置为1:0:1是符合规则的，该配置可保证SONAME仍为libxxx.so.0，旧版本编译的二进制无需重编即可正常使用新库。

2. 新增符号版本脚本

在项目目录下新建版本脚本文件（如libxxx.map），内容示例如下：

LIBXXX_0.0 {
    global: *;
};

LIBXXX_1.0 {
    global:
        新函数名1;
        新函数名2;
        # 此处列出所有新增的API/ABI符号
} LIBXXX_0.0;

3. 关联版本脚本到编译配置

修改libtool的链接参数，指定使用上述版本脚本：

libxxx_la_LDFLAGS = -version-info 1:0:1 -Wl,--version-script=$(srcdir)/libxxx.map

效果验证

• 旧二进制仅依赖LIBXXX_0.0版本的符号，新库完整兼容，可直接运行
• 新编译的二进制如果用到新增接口，会自动依赖LIBXXX_1.0版本标记，在仅安装旧版库的环境中，动态链接器加载时找不到对应版本的符号，会直接在加载阶段报错，不会等到运行时才触发。

方案二：启用立即绑定（无需维护符号列表） #

如果你不想单独维护符号版本列表，可以通过强制开启立即绑定实现加载阶段校验，缺点是会略微增加程序启动耗时。
仅需修改libtool链接参数即可：

libxxx_la_LDFLAGS = -version-info 1:0:1 -Wl,-z,now

该配置会让所有链接该库的二进制默认开启立即绑定，加载阶段就会解析所有依赖符号，不存在就直接报错。

内容的提问来源于stack exchange，提问作者Mathieu Borderé