📚 课程目录第1章多设备蓝牙场景的依赖冲突根源

1. 多设备蓝牙场景的依赖冲突根源

在同时连接蓝牙耳机、手表、车机等多设备时，多个独立模块（如音频路由、协议栈适配、HCI 传输）可能引用同一蓝牙库的不同版本或不同实现。依赖冲突即由此产生：模块 A 依赖 libbluez‑5.54，模块 B 依赖 libbluez‑5.48，链接时导致符号重定义或运行时 ABI 不兼容。理解冲突类型、风险等级以及检测方法是实现模块边界隔离的前提。

1.1 依赖冲突类型

冲突类型	触发场景	典型案例
符号冲突	两个静态库或共享库导出了同名全局符号	模块 A 的 `bt_gatt_write` 与模块 B 的旧版实现同名，链接器选择其一，运行时行为错误
版本不一致	同一库的 major/minor 不同，ABI 不兼容	模块 A 使用 libbluetooth.so.3.0（struct bt_device 含 5 个字段），模块 B 使用 libbluetooth.so.2.8（3 个字段），堆栈错位
间接依赖撕裂	依赖链中不同子模块拉入不同版本的传递依赖	模块 A → libhci.so → libtcp.so:1.0；模块 B → libhci.so → libtcp.so:2.0，链接时 ld 根据搜索顺序选取一个版本，另一个未被使用的对象残留
头文件宏/内联函数差异	编译期包含的头文件与运行时库来自不同版本	头文件中 `BT_SCO_PKT_SIZE` 定义为 60，运行库实际支持 48，内存越界

1.2 冲突风险与影响

运行时崩溃（SIGSEGV）：ABI 变化导致函数调用栈或对象首地址偏移错误，在蓝牙数据回调中尤为隐蔽。
功能静默失效：例如 LE Secure Connections 因符号解析到旧版链接实现而退化回 Legacy Pairing，日志无报错。
性能抖动：多个动态链接器加载同一.so 的不同副本，TLB 缓存失效，音频帧处理延迟飙升。
OTA 升级断裂：蓝牙固件与 Host 栈版本耦合，依赖冲突导致蓝牙模块初始化失败，固件无法回滚。

关键风险指标： 多设备蓝牙场景下，80% 的偶发断连和配对失败可追溯到间接依赖撕裂或头文件宏偏移。建议在 CI 阶段强制执行全链路依赖一致性检查。

1.3 依赖冲突检测方法

1.3.1 静态分析

使用 nm 或 objdump 导出所有目标文件/库的全局符号表，再通过 comm 对比找出重复符号。

# 导出模块 A 和模块 B 的全局符号（过滤掉弱符号）
nm --defined-only --extern-only module_a.a | grep -E ' [TDC] ' | awk '{print $3}' | sort -u > sym_a.txt
nm --defined-only --extern-only module_b.a | grep -E ' [TDC] ' | awk '{print $3}' | sort -u > sym_b.txt
# 找出交集（冲突符号）
comm -12 sym_a.txt sym_b.txt

对于共享库，检查 DT_NEEDED 列表并递归解析，确认是否存在同一 so 的不同 soname。

# 递归解析依赖树（Linux）
ldd libbluetooth_ext.so | awk '{print $1}' | sort -u | while read lib; do
    if [ -f "$lib" ]; then
        objdump -p "$lib" | grep SONAME
    fi
done

1.3.2 动态追踪

在 Android 上使用 dlopen 拦截或 LinkerNamespace 诊断；在 iOS 上利用 dyld 的 DYLD_PRINT_LIBRARIES 环境变量。

# iOS：启动 app 时在 Xcode 中设置环境变量
DYLD_PRINT_LIBRARIES=1
# 输出会显示每个动态库的实际加载路径，可检索冲突版本

1.3.3 构建期 CMake 检查

在 CMake 中添加自定义目标，强制所有目标对同一共享库使用同一版本。

# CMakeLists.txt 片段
find_library(BLUEZ_LIB NAMES libbluetooth.so.3 libbluetooth.so.2 PATHS /usr/lib /vendor/lib)
if(BLUEZ_LIB MATCHES "libbluetooth.so\\.2")
    message(FATAL_ERROR "Deprecated bluetooth library (v2) pulled in by ${CMAKE_CURRENT_SOURCE_DIR}")
endif()

检测技巧： 在 Linux 上可使用 lddtree 可视化依赖树；在 Android 上利用 readelf -d 配合 grep 查找冲突的 NEEDED 条目。对于 iOS，dyld_info -output_dylibs 可打印每个已加载库的 UUID，方便比对版本。

1.4 常见检测误区与预防

误判同版本别名：同一库的多个符号链接（libbluetooth.so → libbluetooth.so.3）不会触发冲突，需检查 soname 而非文件名。
忽略弱符号：某些库将函数定义为 __attribute__((weak))，静默覆盖非弱符号，导致预期功能被替换。建议用 nm -u 查看未定义引用。
动态加载绕过：使用 dlopen("libxxx.so", RTLD_LAZY | RTLD_LOCAL) 可能加载副本而不产生符号冲突，但会浪费内存且增加关闭时的资源泄漏风险。