先理清楚你的场景哈：你已经成功给树莓派3交叉编译好了Qt 5.9.4，基础应用测试跑起来都没问题；接着你做了个静态库SlaveDeviceModels，把它部署到树莓派的/home/pi/Documents/QtProjectsTests/SmartHomeServer目录，还特意用export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/pi/Documents/QtProjectsTests/SmartHomeServer设置了库路径；但在控制台应用SmartHomeServer里添加这个外部库后就出问题了——可惜你没说具体是啥异常，是编译报错？运行时崩溃？还是提示找不到库？

我先基于Qt静态库在树莓派环境下的常见坑，给你几个排查方向：

1. 先确认静态库的编译兼容性 #

• 一定要保证SlaveDeviceModels是用和你SmartHomeServer完全一样的Qt 5.9.4交叉编译工具链构建的，包括架构（树莓派3是armv7l）、C++标准、Qt模块依赖这些细节都得一致。静态库和主项目编译环境不匹配的话，链接时或者运行时很容易出各种奇怪的问题。
• 检查静态库有没有把依赖的Qt模块符号都包含进去，比如如果库里面用到了Qt Core的类，编译库的时候得确保已经正确链接了Qt Core的静态库。

2. 别搞混静态库和动态库的配置！ #

• 你设置的LD_LIBRARY_PATH是给动态库用的啊！静态库在编译的时候就会直接把代码打包进可执行文件里，运行时根本不需要加载外部库文件，所以这个环境变量对静态库来说完全没用，反而可能让你排查方向跑偏。
• 打开SmartHomeServer的.pro文件，检查静态库的链接配置对不对：

  # 指定库所在路径
  LIBS += -L/home/pi/Documents/QtProjectsTests/SmartHomeServer
  # 链接静态库，注意静态库一般是libxxx.a，所以这里写-lSlaveDeviceModels就会找libSlaveDeviceModels.a
  LIBS += -lSlaveDeviceModels
  # 别忘了加头文件路径
  INCLUDEPATH += /path/to/your/SlaveDeviceModels/headers
  

3. 运行时异常的排查方法（如果是运行时出问题） #

• 如果是运行时崩溃，用树莓派上的gdb调试一下，能快速定位问题：

  # 启动gdb加载你的可执行文件
  gdb ./SmartHomeServer
  # 运行程序
  run
  # 崩溃后输入bt查看调用栈，就能知道是哪段代码出问题了
  bt
  

• 用ldd ./SmartHomeServer命令看看可执行文件的动态依赖，确认Qt的动态库（比如libQt5Core.so.5这些）都能被找到——虽然你用了静态库，但主项目本身可能还是依赖Qt的动态库，这些得在LD_LIBRARY_PATH里能找到。

4. 编译时错误的常见原因 #

• 如果是编译时提示找不到符号，要么是静态库没正确导出符号，要么是你调用了库里面没对外暴露的函数/类。检查库的头文件，要是C++库给C代码用的话，得用extern "C"包裹；要是Qt类库，得用正确的Qt导出宏（比如Q_DECL_EXPORT）。
• 如果提示找不到库文件，先确认树莓派上的库文件名是不是libSlaveDeviceModels.a（静态库的命名规则一般是lib开头，.a后缀），再检查Qt Creator里指定的库路径是不是完全准确。

要是你能补充具体的异常信息，比如错误日志、报错截图或者崩溃时的具体现象，我就能更精准地帮你定位问题啦！

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