昨天上车自测本模块功能稳定性,顺便pull小弟分支,帮忙一起验证。结果小包上车后无法运行,一查发现一直报
undefined symbol: XXXXXX
晚上下班后开始帮忙排查。今日记录以便后期回顾。
前两年写过一篇关于undefined symbol 问题的排查贴,但发生undefined symbol的情况有多种,一篇不足以盖全。
报错分析
undefined symbol 为 符号未定义,意味着程序的符号表中找不到这个符号。符号表是什么这里就简述一下不多说了,感兴趣可以去看一下编译原理(有空我也研究一下写个专栏博,hhh)。
先简单了解一下编译过程:
简述一下符号表的含义和作用:
在链接后,代码中的各种符号(函数、变量等)都被分配了地址,并将信息记录在符号表中。
例如:
存在一个函数 void function(int x) ,系统先在内存上分配一块内存,设地址为10010,再将函数标识符function、void关键字标识符和地址10010等信息记录到符号表中。
当符号被使用时,系统会去符号表里查询地址,通过查询到的地址去获取相应的信息来使用。
解决办法
通常undefined symbol的发生有两种情况:
-
找不到依赖的动态库
这种需要看一下自己的makefile或者动态库配置文件,动态库名字或者路径是否有问题、调用的库版本是否正确。可参考我的第一篇文章。
undefined symbol 问题解决记录(一)
-
能够找到依赖的动态库
现在就来说一下这种情况的解决办法。
方法一:是否编译时链接了错误的库
在编译指令上加入:
-Xlinker --unresolved-symbols=ignore-in-shared-libs
重新编译。若出现undefined symbol:xxx,再加上xxx的库以及正确路径等重新编译。
再运行看是否还报错。
方法二:通过报错问题库的符号表定位
找到编译好的库,输入指令查看该库的符号:
nm -g libxxx.so
符号较多,建议直接输出一个文档方便查看。
nm -g libxxx.so > symbol.txt
找到问题函数。
比如:
小弟分支编译后运行报错
使用 c++filt 查看符号对应的函数
在符号表中查找对应的函数符号
这里发现存在相同的函数符号,两个符号的差别是一个存在标识符“ChartMsgGeneration”,一个没有这个类型标识符。
这个函数是小弟新实现的,按照代码规范要求,正常来说我们不会有同名函数。搜索其他函数符号,表里也只存在一个。回归到代码中溯源找到了问题原因。
在小弟的代码中,新写入的函数声明为类的静态成员函数,而在.cpp文件中的函数实现时,未在函数前使用父类修饰。导致在编译链接时出现两个函数符号,在调用运行时混淆。
xxx.h 文件里
namespace li_pilot {
namespace chart_engine_runtime {
class ChartMsgGeneration {
private:
static void GenCityLCStrategyInfoBehaviorMsg();
};
}
}
xxx.cpp 文件里
namespace li_pilot {
namespace chart_engine_runtime {
void GenCityLCStrategyInfoBehaviorMsg() {
// 代码实现
return;
}
}
}
最后在函数实现前把父类加上,重新编译后再运行,没有出现问题。(这里也是瞎,转圈找半天没发现少了父类。。根本没想到会有这样鱼唇的问题)
xxx.cpp 文件里
namespace li_pilot {
namespace chart_engine_runtime {
void ChartMsgGeneration::GenCityLCStrategyInfoBehaviorMsg() {
// 代码实现
return;
}
}
}
引申问题:为什么.cpp里 函数体没有父类修饰编译时没有报错呢?
这里又是另一个知识点了:静态成员
抽空再另外补充吧(等我福至心灵想勤快的时候),不在这里赘述了。感兴趣的同学自行百度一下。。