NAO Python 2.8 SDK部署报错：_qi.so库文件找不到

• 检查文件权限
  先确认_qi.so的权限是否允许当前用户读取执行：

  ls -l /home/pi/pynaoqi-python2.7-2.8.6/lib/python2.7/site-packages/_qi.so
  

  若权限不包含可读可执行位，执行以下命令修改：

  sudo chmod 755 /home/pi/pynaoqi-python2.7-2.8.6/lib/python2.7/site-packages/_qi.so
  

• 更新locate数据库
  locate找不到文件是因为系统索引未更新，执行以下命令刷新：

  sudo updatedb
  

  之后再用locate _qi.so即可查到文件路径。

• 添加Python模块搜索路径
  确认Python能否识别该库所在目录：在Python2.7交互环境中执行：

  import sys
  print(sys.path)
  

  若输出中没有/home/pi/pynaoqi-python2.7-2.8.6/lib/python2.7/site-packages，按以下方式添加：

  • 临时生效（仅当前会话）：

    sys.path.append("/home/pi/pynaoqi-python2.7-2.8.6/lib/python2.7/site-packages")
    

  • 永久生效：编辑~/.bashrc文件，加入该行后执行source ~/.bashrc：

    export PYTHONPATH="/home/pi/pynaoqi-python2.7-2.8.6/lib/python2.7/site-packages:$PYTHONPATH"
    

• 配置动态链接库路径
  系统可能无法定位_qi.so依赖的库，可通过以下方式添加路径：

  • 临时生效：

    export LD_LIBRARY_PATH="/home/pi/pynaoqi-python2.7-2.8.6/lib/python2.7/site-packages:$LD_LIBRARY_PATH"
    

  • 永久生效：编辑~/.bashrc加入上述命令，执行source ~/.bashrc；或配置系统级路径：

    sudo echo "/home/pi/pynaoqi-python2.7-2.8.6/lib/python2.7/site-packages" >> /etc/ld.so.conf.d/naoqi.conf
    sudo ldconfig
    

• 验证库架构兼容性
  树莓派为ARM64架构，确认下载的SDK匹配该架构：

  file /home/pi/pynaoqi-python2.7-2.8.6/lib/python2.7/site-packages/_qi.so
  

  输出需包含aarch64字样，若为x86_64则需重新下载对应ARM64版本的SDK。

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