CMake编译时调用Customer类get_uuid()出现未定义引用错误

问题背景 #

链接程序时出现Customer::get_uuid[abi:cxx11]()未定义引用错误，已排查头文件声明与实现匹配性、循环依赖、前向声明、链接库顺序，均未解决问题。

错误信息 #

libdatamanager.a(datamanager.cpp.obj):datamanager.cpp:(.text+0x93): undefined reference to `Customer::get_uuid[abi:cxx11]()'        
libdatamanager.a(datamanager.cpp.obj):datamanager.cpp:(.text+0x11a): undefined reference to `Customer::get_uuid[abi:cxx11]()'       
collect2.exe: error: ld returned 1 exit status
CMakeFiles\mtm-app.dir\build.make:106: recipe for target 'mtm-app.exe' failed
mingw32-make.exe[2]: *** [mtm-app.exe] Error 1
CMakeFiles\Makefile2:261: recipe for target 'CMakeFiles/mtm-app.dir/all' failed
mingw32-make.exe[1]: *** [CMakeFiles/mtm-app.dir/all] Error 2
Makefile:134: recipe for target 'all' failed
mingw32-make.exe: *** [all] Error 2

相关代码 #

Customer.h #

#include <iostream>
#include "customerdata.h"

#ifndef CUSTOMER_H
#define CUSTOMER_H

class Customer
{
private:
    std::string name;
    std::string uuid;
    CustomerData* customerData;
public:
    Customer( std::string uuid, std::string name, CustomerData* CustomerData );

    Customer( std::string name, CustomerData* CustomerData );

    std::string get_name();

    std::string get_uuid();

    CustomerData* get_customer_data();
};

#endif

Customer.cpp #

#include "customer.h"
#include "customerdata.h"
#include "../util.cpp"
#include <iostream>

Customer::Customer( std::string uuid, std::string name, CustomerData* customerData )
{
    this->name = name;
    this->uuid = uuid;
    this->customerData = customerData;
}

Customer::Customer( std::string name, CustomerData* customerData )
{
    this->name = name;
    this->uuid = uuid::generate_uuid();
    this->customerData = customerData;
}

std::string Customer::get_name()
{
    return this->name;
}

std::string Customer::get_uuid()
{
    return this->uuid;
}

CustomerData* Customer::get_customer_data()
{
    return this->customerData;
}

DataManager.h #

#include <iostream>
#include <unordered_map>
#include "../container/customer.h"

#ifndef DATAMANAGER_H
#define DATAMANAGER_H

class DataManager
{
private:
    std::unordered_map<std::string, Customer*> customers = {};
public:
    DataManager();

    void add_customer( Customer* Customer );

    void remove_customer( Customer* customer );

    std::unordered_map<std::string, Customer*> get_customers();
};

#endif

DataManager.cpp #

#include "datamanager.h"
#include <iostream>
#include <unordered_map>
#include "../container/customer.h"

DataManager::DataManager()
{
    
}

std::unordered_map<std::string, Customer*> DataManager::get_customers()
{
    return this->customers;
}

void DataManager::add_customer( Customer* customer )
{
    this->customers.insert( std::make_pair( customer->get_uuid(), customer ) );
}

void DataManager::remove_customer( Customer* customer )
{
   this->customers.erase( customer->get_uuid() );
}

CMakeLists.txt #

cmake_minimum_required(VERSION 3.27.0)
project(MTMApp VERSION 1.0.0)

add_library(
    util
    util.cpp
)

add_library(
    insurance
    container/insurance.h
    container/insurance.cpp
)

add_library(
    customerdata
    container/customerdata.h
    container/customerdata.cpp
)

add_library(
    customer
    container/customer.h
    container/customer.cpp
)

add_library(
    datamanager
    data/datamanager.h
    data/datamanager.cpp
)

add_subdirectory(SQLiteCpp)

add_executable(mtm-app app.cpp)

target_link_libraries(mtm-app
    sqlite3
    SQLiteCpp
    util
    insurance
    customerdata
    customer
    datamanager
)

排查方向与解决方法 #

1. 统一C++ ABI版本 #

错误中的[abi:cxx11]是核心线索，说明编译datamanager和customer库时，C++标准库的ABI版本不一致。

• 解决：在CMakeLists.txt开头添加全局编译定义，强制所有目标使用同一ABI版本：

  add_compile_definitions(_GLIBCXX_USE_CXX11_ABI=1)
  

  若需兼容旧项目可设为0，但必须保证所有库的编译参数统一。

2. 明确库的依赖关系 #

datamanager依赖customer库，但当前CMake未声明该依赖，可能导致链接顺序或符号查找异常。

• 解决：在datamanager库定义后添加依赖声明：

  add_library(
      datamanager
      data/datamanager.h
      data/datamanager.cpp
  )
  target_link_libraries(datamanager PUBLIC customer)
  

  这样CMake会自动处理依赖传递与链接顺序，确保datamanager能正确找到customer的符号。

3. 修正头文件包含路径 #

检查datamanager.cpp中#include "../container/customer.h"的路径是否正确，避免因路径错误引用了无关的头文件。

• 解决：为datamanager库设置正确的包含目录，然后简化头文件引用：

  target_include_directories(datamanager PUBLIC ${CMAKE_SOURCE_DIR}/container)
  

  修改datamanager.cpp中的包含语句为#include <customer.h>。

4. 强制库的构建顺序 #

静态库的构建顺序可能影响符号可用性，需确保customer库先于datamanager构建。

• 解决：添加显式依赖声明：

  add_dependencies(datamanager customer)
  

内容的提问来源于stack exchange，提问作者Morărescu Mihnea