Linux下gcc编译C++程序链接静态动态库方法与报错处理

报错根因 #

/usr/bin/ld: warning: libtls_64.so, needed by /mnt/f/code/ext/verifp_1.40/bin/linux/x64/libverifp.so, not found (try using -rpath or -rpath-link)

该警告本质是：你主动链接的静态库libtls_64.a仅对你自己的代码生效，而你要链接的动态库libverifp.so本身在编译阶段就声明了依赖动态版libtls_64.so，链接器在当前配置的库搜索路径下找不到这个依赖的动态库，因此抛出提示。

具体配置步骤 #

1. 明确静态/动态库链接规则，避免版本混淆 #

g++链接时默认优先匹配同名动态库（.so），如果同目录下同时存在静态库（.a）和动态库，直接使用-lxxx参数会优先链接动态版本，和你要静态链接libverifp.a、libtls_64.a的需求冲突，有两种稳妥的写法：

• 写法1：直接写静态库全路径，不需要切换链接模式，出错概率最低
• 写法2：用-Wl,-Bstatic包裹需要静态链接的库，链接完立刻用-Wl,-Bdynamic切回动态链接模式，避免后续系统库被强制静态链接

2. 添加库搜索路径与依赖查找参数 #

需要把库存放的路径（即libverifp.so、libtls_64.so所在的/mnt/f/code/ext/verifp_1.40/bin/linux/x64目录）加入链接配置，同时选择以下一个参数解决动态库依赖查找问题：

• -Wl,-rpath-link=路径：仅在编译链接阶段告知链接器去指定路径查找依赖动态库，不会把路径写入最终生成的可执行文件，不影响程序运行时的库搜索逻辑
• -Wl,-rpath=路径：除了链接阶段生效，还会把路径硬编码到可执行文件的动态库搜索列表中，程序运行时不需要额外配置LD_LIBRARY_PATH即可找到依赖库，适合库存放路径不在系统默认库目录（/usr/lib、/usr/local/lib等）的场景

Makefile配置示例 #

以下是可直接参考的配置片段，替换成你自己的项目路径即可：

# 配置头文件搜索路径
INCLUDE_PATH := -I/mnt/f/code/ext/verifp_1.40/include
# 配置库存放根路径
LIB_PATH := /mnt/f/code/ext/verifp_1.40/bin/linux/x64

# 编译参数
CXXFLAGS := -Wall -O2 $(INCLUDE_PATH)
# 链接参数
LDFLAGS := -L$(LIB_PATH)
# 优先链接两个静态库（全路径写法，不会错链动态版）
LDFLAGS += $(LIB_PATH)/libverifp.a $(LIB_PATH)/libtls_64.a
# 链接动态库libverifp.so
LDFLAGS += -lverifp
# 添加rpath解决动态库依赖查找问题，不需要硬编码运行时路径就换成-rpath-link
LDFLAGS += -Wl,-rpath=$(LIB_PATH)

# 编译规则示例
all: your_target
your_target: main.o
	g++ -o $@ $^ $(LDFLAGS)
main.o: main.cpp
	g++ $(CXXFLAGS) -c $< -o $@

.PHONY: clean
clean:
	rm -f *.o your_target

注意事项 #

• 链接参数顺序严格遵循「依赖方在前，被依赖方在后」的规则，顺序错误会触发undefined reference类报错
• 若使用-Wl,-Bstatic/-Wl,-Bdynamic切换链接模式，必须在静态库链接完成后切回动态模式，否则会出现系统库（如libc、libstdc++）静态链接失败的问题
• 配置完成后可以执行ldd 你的可执行文件命令检查动态库依赖是否都能被正常找到

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