Linux 动态库踩坑:明明重新编译了 .so,调用函数返回值却一直不变(libfjrobot.so 版本号异常排查实录)

最近在写机器人 SDK 的 Demo 程序,遇到一个非常经典的动态链接坑:Demo 调用 libfjrobot.so 里的 GetSDKVersion() 获取版本号,无论怎么修改库源码、重新编译,打印出来的版本号始终和预期不一致。

现象

我修改 SDK 源码、执行 make 重新编译生成新的 libfjrobot.so,编译日志看着一切正常,但是运行 Demo 后,GetSDKVersion() 返回的版本号一直是旧值,不会更新。

第一步排查:确认程序到底加载了哪一份 so

Linux 下程序运行时,动态链接器会按照固定的搜索顺序去找 .so 文件,并不是优先加载当前目录或者你刚刚编译出来的库 。 用 ldd 命令查看 Demo 实际依赖的库路径:

复制代码
ldd ./demo

我的输出:

复制代码
libfjrobot.so => /lib/libfjrobot.so

问题直接定位: Demo 加载的是 /lib/libfjrobot.so,是之前拷贝到系统目录的旧版本库;我本地新编译出来的 libfjrobot.so,程序根本没有加载。 哪怕我反复编译本地源码,程序跑的依旧是老库,版本号自然不会变。

原理:Linux 动态链接搜索顺序:LD_LIBRARY_PATH → /etc/ld.so.conf 配置路径 → /lib、/usr/lib 等系统默认库目录。系统目录里同名库优先级很高,很容易抢占加载。

两种修复方案

方案 1:开发调试临时方案(推荐日常调试)

运行前设置 LD_LIBRARY_PATH,优先加载本地编译出来的库,不改动系统文件:

复制代码
# 指定优先搜索本地库路径
export LD_LIBRARY_PATH=./x86-64:$LD_LIBRARY_PATH
# 校验加载路径是否切换成功
ldd ./demo
# 启动demo
./demo

新开终端需要重新执行这条环境变量命令,适合开发调试,不会污染系统。

方案 2:永久替换(我本次使用的方案,虚拟机开发环境适用)

⚠️ 注意:只适合专属开发虚拟机,生产环境不要随意操作 /lib!

  1. 删除系统目录里遗留的旧库

    rm -f /lib/libfjrobot.so

  2. 把刚刚编译完成的新版库复制到系统库目录

    cp ./x86-64/libfjrobot.so /lib/

再次运行 Demo,GetSDKVersion() 返回版本号和源码预期一致,问题解决。

相关推荐
15Moonlight12 分钟前
Linux 网络(11):IO 多路转接(select /poll/epoll)
linux·网络
Hhy_110714 分钟前
《C++深度解构07》手撕 vector —— 从底层三指针架构到迭代器失效彻底吃透
c语言·开发语言·c++·学习·visual studio
风落青芜23 分钟前
链式二叉树的实现与基本操作
c语言·开发语言·数据结构·算法
艾莉丝努力练剑1 小时前
【QT】系统相关:TCP的API介绍
开发语言·前端·c++·人工智能·qt·学习·tcp/ip
峥嵘life1 小时前
Android16 热点「网络共享」开关的设计与实现
服务器·网络·microsoft
青少儿编程课堂1 小时前
蓝桥杯·全国青少年信息素养大赛·电子学会Python/C++考级:中国剩余定理解析
c++·python·算法·bfs·信息学竞赛
wno7042 小时前
CentOS下FTP服务搭建
linux·运维·centos
wo_jack2 小时前
C++ 入门笔记(十八):list 进阶 —— const 迭代器、operator-> 与 clear 的坑
数据结构·c++·面试·stl·list
15Moonlight2 小时前
Linux网络(12):Reactor 模式
linux·网络
ShineWinsu2 小时前
对于Qt:QVBoxLayout常见属性以及方法的解析
开发语言·数据库·c++·qt·gui·客户端·布局管理器