Linux下libusb示例运行时出现libusb_init_context未定义符号错误

出现undefined symbol: libusb_init_context错误的核心原因是程序运行时加载的libusb-1.0动态库版本，低于编译时头文件依赖的版本。

libusb_init_context是libusb-1.0.21版本才新增的API，如果你的系统中：

• 编译时用的是≥1.0.21版本的libusb头文件
• 但运行时程序加载的是<1.0.21版本的libusb动态库

就会触发这个符号找不到的错误——编译阶段只检查头文件中的函数声明，动态链接阶段不会验证符号是否存在，只有运行时加载库才会真正查找符号。

排查与修复步骤 #

• 确认版本差异

  1. 查看编译时依赖的libusb版本：

     pkg-config --modversion libusb-1.0
     

  2. 查看程序运行时实际链接的libusb库路径：

     ldd ./main2 | grep libusb
     

  3. 检查该库的实际版本：

     strings $(ldd ./main2 | grep libusb | awk '{print $3}') | grep LIBUSB_1.0 | sort -V
     

     输出中如果没有LIBUSB_1.0.21或更高版本的标识，说明运行时库版本过低。

• 修复方案

  1. 升级系统libusb：如果系统包管理器有更高版本，直接升级，比如Debian/Ubuntu系：

     sudo apt update && sudo apt install --only-upgrade libusb-1.0-0-dev libusb-1.0-0
     

  2. 指定运行时库路径：如果是自己编译了高版本libusb但未替换系统库，可临时设置环境变量让程序加载正确的库：

     LD_LIBRARY_PATH=/path/to/your/compiled/libusb/lib ./main2
     

     （把/path/to/your/compiled/libusb/lib替换成你编译的libusb库所在目录）
  3. 编译时指定库路径：重新编译时，用-L参数指定高版本libusb的库路径，确保链接到正确版本：

     g++ -o main2 main2.cpp -L/path/to/your/compiled/libusb/lib -llog4cpp -lcurl -lusb-1.0
     

     同时可以加上-Wl,-rpath=/path/to/your/compiled/libusb/lib，让程序运行时自动加载该路径下的库，无需每次设置环境变量。

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