VS2019升级后clang报undefined reference但nm显示符号存在如何排查

你遇到的符号找不到错误主要来自三类常见原因：

1. 符号名完全不匹配：报错的attrVarIndex::hCattrVarIndex(int, unsigned long)和你从静态库查到的attrVarIndex::attrVarIndex(int, unsigned long)明显存在前缀差异，属于声明和实现的符号名不一致。
2. 静态库链接顺序错误：Clang/GCC的静态库链接遵循「依赖方在前，被依赖方在后」的扫描规则，只会按顺序遍历一次静态库，如果引用符号的编译单元所属的库，排在定义该符号的库之后，链接器就会漏掉符号定义。VS 2019 16.11版本升级后可能修改了默认的链接参数，关闭了自动组扫描规则，导致之前正常的顺序现在失效。
3. 编译参数不一致：如果依赖库和当前构建的.so的编译参数存在差异（比如wchar_t长度、C++标准、可见性配置、调用约定等），哪怕参数列表肉眼看起来完全一致，符号签名也会不匹配，导致链接失败。

• 优先处理符号名不匹配问题：全局搜索代码中所有hCattrVarIndex字符串，排查是否存在错误的宏定义意外修改了类名/构造函数名，或者头文件中构造函数的声明拼写错误。
• 验证链接顺序问题：最快的验证方案是在链接器附加选项中，将所有静态库放在-Wl,--start-group和-Wl,--end-group参数之间，让链接器反复扫描所有静态库直到所有符号解析完成，不需要手动调整顺序。如果该操作解决了剩下两个符号的报错，就说明是链接顺序问题，后续可以再根据依赖关系手动调整顺序减少链接耗时。
• 检查编译参数一致性：对比所有依赖静态库和当前.so的编译参数，重点核对-fshort-wchar开关（会修改wchar_t长度，直接影响带wchar_t参数的函数签名）、C++标准版本、-fvisibility配置、RTTI/异常开关，保证所有编译单元的参数完全一致。
• 逐字符对比符号签名：去掉nm命令的--defined-only参数，分别查询当前.so编译生成的.o文件中的未定义符号，和静态库中的定义符号，确认是否存在const修饰、参数长度等肉眼容易忽略的差异。

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