Qt+Cmake项目中静态库函数间接调用时断点失效问题

问题分析 #

调试GUI应用时，SDK静态库的函数被core共享库调用时断点不触发，但直接被GUI调用时正常，核心原因和CMake配置及编译行为有关：

1. SDK静态库为空，函数被内联编译 #

你的SDK静态库CMake配置中，add_library仅包含头文件MP/Utils.h，没有对应的.cpp实现文件。由于MP::Utils::sum是在头文件中直接定义的静态成员函数，编译器会将其视为内联函数：

• 编译core共享库时，sum函数的代码会直接内联到doAnOperation的实现中，完全不会用到空的SDK静态库。
• 调试时，断点设置在SDK头文件的sum函数上，调试器无法关联到core库中已内联的代码片段，因此不会触发断点。
• GUI直接调用时，sum函数被内联到GUI进程的二进制文件中，调试器能直接匹配到当前进程的代码符号，断点正常触发。

2. CMake配置的其他错误 #

• desktop-gui的target_link_libraries目标写错：应该使用${PROJECT_NAME}（对应desktop-gui），而非Application，这会导致链接依赖异常。
• 未显式指定Debug模式的编译选项：虽然CMake默认Debug模式会生成调试信息，但显式配置可避免环境差异导致的符号缺失。

解决方案 #

1. 修复SDK静态库配置 #

将函数实现移到.cpp文件，避免内联导致的调试问题：

• 在SDK/MP/下创建Utils.cpp：

#include "Utils.h"

namespace MP {
    int Utils::sum(int a, int b) {
        return a + b;
    }
}

• 修改SDK/CMakeLists.txt：

cmake_minimum_required(VERSION 3.14)

project(sdk LANGUAGES CXX)

find_package(Qt5 REQUIRED COMPONENTS Core)

add_library(${PROJECT_NAME} STATIC
  MP/Utils.h
  MP/Utils.cpp  # 添加实现文件
)

target_include_directories(${PROJECT_NAME} PUBLIC "${CMAKE_CURRENT_SOURCE_DIR}/MP")
target_link_libraries(${PROJECT_NAME} PRIVATE Qt5::Core)

# Debug模式强制生成调试信息、关闭优化
target_compile_options(${PROJECT_NAME} PRIVATE
  $<$<CONFIG:Debug>:-g -O0>
)

2. 完善core库调试配置 #

确保core库在Debug模式下保留调试符号：

cmake_minimum_required(VERSION 3.14)

project(core LANGUAGES CXX)

find_package(Qt5 REQUIRED COMPONENTS Core)

add_library(core SHARED
  core_global.h
  Core.cpp
  Core.h
)

target_include_directories(${PROJECT_NAME} PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})
target_link_libraries(${PROJECT_NAME}
    PRIVATE
        Qt5::Core
    PUBLIC
        sdk
)
target_compile_definitions(${PROJECT_NAME} PUBLIC CORE_LIBRARY)

# Debug模式生成调试信息、关闭优化
target_compile_options(${PROJECT_NAME} PRIVATE
  $<$<CONFIG:Debug>:-g -O0>
)
# 确保共享库保留调试符号
set_target_properties(${PROJECT_NAME} PROPERTIES
  DEBUG_POSTFIX d
)

3. 修正desktop-gui的链接配置 #

cmake_minimum_required(VERSION 3.14)

project(desktop-gui LANGUAGES CXX)

find_package(Qt5 REQUIRED COMPONENTS Core)

add_executable(${PROJECT_NAME}
  main.cpp
)

# 修正链接目标为当前项目名
target_link_libraries(${PROJECT_NAME}
    Qt5::Core
    sdk
    core
)

# Debug模式生成调试信息、关闭优化
target_compile_options(${PROJECT_NAME} PRIVATE
  $<$<CONFIG:Debug>:-g -O0>
)

4. 重新构建调试 #

• 在Qt Creator中切换到Debug模式
• 执行Clean操作后重新构建整个项目
• 再次调试，core调用MP::Utils::sum时断点会正常触发

额外说明 #

如果必须保留头文件内联函数的写法，可以尝试给所有目标添加-fno-inline编译选项（禁用内联优化），但这种方式稳定性不如将实现移到.cpp文件。

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