Go嵌入C调用USB设备库：跨Linux主机运行异常求助

环境与背景 #

• 硬件：内置单按钮与LED的USB设备，硬件API仅提供C语言实现
• 实现方式：Go代码中嵌入C代码，静态链接libultimarc.a和libusb-1.0.a，其余依赖库动态链接
• 编译主机：x86_64架构Ubuntu，测试主机：同架构Debian
• 现象：编译主机上程序运行正常，可修改LED颜色；测试主机上程序无响应，仅处于阻塞等待状态，可通过Ctrl+C终止

Go嵌入C代码示例（goC-LedButton.go） #

package main
/*
// Everything in comments above the import "C" is C code and will be compiled with GCC. 
#cgo LDFLAGS: "/home/user/BUTTON/Ultimarc-linux/src/libs/.libs/libultimarc.a"  "/home/user/BUTTON/libusb-1.0.26/libusb/.libs/libusb-1.0.a" "-ludev" "-ljson-c" 
// path of json.h
#cgo CFLAGS: "-I/usr/local/include/json-c/" 

#include "Ultimarc-linux/src/libs/ulboard.h"
#include "Ultimarc-linux/src/libs/common.h"
#include "Ultimarc-linux/src/libs/usbbutton.h"
#include "Ultimarc-linux/src/libs/ipacseries.h"

#include <json.h>

int changeColor(char *str) {
    ulboard myboard;
    myboard.type = ulboard_type_usbbutton;
    myboard.version = ulboard_version_null;
    struct json_object *parsed_json_color;
    _Bool ret;
    parsed_json_color = json_tokener_parse(str);
    ret = updateBoardUSBButtonColor(parsed_json_color, &myboard);
    return ret;
}

int toRed(void) {
    _Bool ret;
    char *str = "{ \"red\" : 255,  \"green\" : 0, \"blue\" : 0 }";
    ret = changeColor(str);
    return ret;
}

int toGreen(void) {
    _Bool ret;
    char *str = "{ \"red\" : 0,  \"green\" : 255, \"blue\" : 0 }";
    ret = changeColor(str);
    return ret;
}

int toBlue(void) {
    _Bool ret;
    char *str = "{ \"red\" : 0,  \"green\" : 0, \"blue\" : 255 }";
    ret = changeColor(str);
    return ret;
}
 */
import "C"
import "fmt"

func main() {
       c := C.toRed()
       fmt.Println("Changing Color to Red ", c )
       
       c = C.toGreen()
       fmt.Println("Changing Color to Green ", c )

       c = C.toBlue()
       fmt.Println("Changing Color to Blue ", c )
}

二进制文件依赖库（ldd输出） #

ldd goC-LedButton
        linux-vdso.so.1 (0x00007ffe9fafa000)
        libudev.so.1 => /lib/x86_64-linux-gnu/libudev.so.1 (0x00007ff9cbd49000)
        libjson-c.so.3 => /lib/x86_64-linux-gnu/libjson-c.so.3 (0x00007ff9cbd3b000)
        libpthread.so.0 => /lib/x86_64-linux-gnu/libpthread.so.0 (0x00007ff9cbd18000)
        libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007ff9cbb26000)
        /lib64/ld-linux-x86-64.so.2 (0x00007ff9cbd9c000)

排查与解决思路 #

• 动态库版本兼容性检查
  即便两台主机都有libjson-c.so.3，不同发行版的库可能存在API/ABI差异：

  • 用dpkg -l libjson-c和dpkg -l libudev分别查看两台主机的库版本，对比是否一致；
  • 用objdump -T goC-LedButton | grep json或objdump -T goC-LedButton | grep udev查看程序依赖的具体符号，再在测试主机的对应库中检查符号是否存在。

• 定位程序阻塞点

  • 用strace ./goC-LedButton追踪系统调用，确认程序卡在哪个环节（如USB设备枚举、udev事件等待、库初始化）；
  • 用gdb ./goC-LedButton调试，在updateBoardUSBButtonColor函数设置断点，逐步排查执行阻塞位置。

• USB设备权限验证
  测试主机可能缺少正确的udev规则导致程序无法访问USB设备：

  • 复制编译主机/etc/udev/rules.d/下的相关规则到测试主机；
  • 执行sudo udevadm control --reload-rules && sudo udevadm trigger重新加载规则后重试。

• 静态链接更多依赖库
  尝试将libudev和libjson-c也静态链接，规避发行版动态库差异：

  • 修改#cgo LDFLAGS，替换-ludev和-ljson-c为对应静态库路径（如/usr/lib/x86_64-linux-gnu/libudev.a、/usr/lib/x86_64-linux-gnu/libjson-c.a），注意处理依赖链（如libudev依赖libsystemd需一并静态链接）。

• 直接在测试主机编译
  避免跨发行版编译的兼容问题，直接在Debian测试主机上编译程序。

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