将静态库打包为单个共享库时paho-mqtt3c.a无法正常工作

核心问题出在链接器的默认优化行为上，以下是具体分析和解决办法：

1. 链接器的符号丢弃逻辑 #

当你用-lpaho-mqtt3c这种方式链接静态库时，链接器会检查当前共享库的编译产物是否直接引用了该静态库的符号。如果你的代码中没有显式调用paho-mqtt的API（比如仅通过回调、动态调用等间接方式使用），链接器会判定该静态库未被使用，直接跳过打包，这就是为什么nm baselib.so看不到MQTT相关符号的原因。其他库能正常显示，大概率是因为代码中有直接调用它们的API。

2. 解决方法一：强制包含整个静态库 #

通过链接器参数--whole-archive强制让链接器把paho-mqtt3c.a的所有符号都打包进共享库，示例CMake配置如下：

# 先定位paho-mqtt3c静态库的路径，替换成你的实际路径
find_library(PAHO_MQTT3C_LIB paho-mqtt3c PATHS ${PROJECT_SOURCE_DIR}/lib)

target_link_libraries(baselib
    PRIVATE
    # 强制包含paho整个静态库，之后恢复默认行为
    -Wl,--whole-archive ${PAHO_MQTT3C_LIB} -Wl,--no-whole-archive
    ljansson
    hiredis
    sqlite3
)

--whole-archive会关闭链接器的未使用符号优化，--no-whole-archive则恢复默认逻辑，避免其他静态库被无差别打包导致共享库体积过大。

3. 解决方法二：添加显式符号引用 #

如果不想强制打包整个库，可以在代码中添加一个空的函数，显式引用paho的某个API，让链接器认为该库被使用：

#include "MQTTClient.h"

// 标记函数不被编译器优化，强制保留
__attribute__((used)) void __force_paho_link(void) {
    // 随便引用一个paho的API即可
    (void)MQTTClient_create;
}

之后在你的库初始化逻辑中调用一次这个函数，或者仅靠__attribute__((used))让编译器保留该函数，链接器就会把paho的符号包含进来。

4. 前置验证：确认静态库本身的符号完整性 #

先执行以下命令，确认paho-mqtt3c.a本身包含MQTT相关符号：

nm /path/to/paho-mqtt3c.a | grep MQTT

如果没有输出，说明静态库本身编译有问题，需要重新编译paho-mqttc库；如果有输出，问题就集中在链接阶段的优化逻辑上，用上面两种方法即可解决。

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