引入mysqlx/xdevapi.h时CMake链接报undefined reference错误如何解决

所有未定义引用都带[abi:cxx11]标识，属于典型的GCC C++ ABI不匹配问题，也可能同时存在依赖库缺失、链接顺序错误的问题，具体原因如下：

• ABI设置不匹配：你使用的预编译libmysqlcppconn8-static.a的编译配置和你项目的默认编译配置不一致。GCC 5及以上版本默认启用_GLIBCXX_USE_CXX11_ABI=1的新CXX11 ABI，如果你下载的官方预编译连接器是用旧ABI（_GLIBCXX_USE_CXX11_ABI=0）编译的，就会出现符号不匹配的链接错误。
• 依赖库缺失：当前的链接配置漏了连接器依赖的pthread、dl系统库，静态链接时会导致符号查找失败。
• 链接顺序错误：静态库的链接顺序需要遵循「被依赖库放在依赖它的库后面」的规则，顺序不对也会导致符号找不到。
• 库版本不匹配：如果误用了旧版本的libmysqlcppconn.a（JDBC接口的连接器），它本身不包含X DevAPI的实现，也会出现这类报错。

你可以按照下面的顺序依次排查修复：

1. 统一项目和连接器的ABI设置
   在你的CMakeLists.txt的add_executable配置之前，添加全局编译定义强制对齐ABI：

# 如果你的连接器是旧ABI编译的就设为0，新ABI编译的就设为1
add_definitions(-D_GLIBCXX_USE_CXX11_ABI=0)

如果不确定连接器的ABI设置，可以两个值都试一次，看哪个能编译通过。

2. 补全依赖库并调整链接顺序
   修改你的target_link_libraries配置，补全缺失的依赖并调整顺序：

target_link_libraries(
  app
  PRIVATE mysql
  PRIVATE ssl
  PRIVATE crypto
  PRIVATE pthread
  PRIVATE dl
  PRIVATE rt
  PRIVATE resolv
)

3. 自行编译连接器源码
   如果上述方案都无效，说明你下载的预编译库和你的环境完全不兼容，可以直接下载MySQL Connector/C++ 8的源码，用你当前项目使用的GCC版本编译，编译时指定和你项目一致的_GLIBCXX_USE_CXX11_ABI参数，编译完成后用生成的静态库替换你现在使用的库即可。

4. 验证库正确性
   确认你使用的库确实是支持X DevAPI的libmysqlcppconn8-static.a，不是旧版本的JDBC接口连接器库。

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