使用ScalaPy遇UnsatisfiedLinkError：无法加载python3库求助

排查库文件路径问题 #

• /usr/bin/python3是Python可执行文件路径，并非库文件所在目录。Python库文件通常以libpython3.x.so命名，存放路径多为/usr/lib/x86_64-linux-gnu/或/usr/lib/这类系统库目录。
• 用命令定位库文件：find /usr -name "libpython3*.so"，找到路径后设置LD_LIBRARY_PATH，示例：

  export LD_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH
  

明确指定Python版本 #

在Scala代码中主动指定Python版本，避免自动检测出错：

import me.shadaj.scalapy.py

object Main extends App {
  py.initialize(pythonVersion = py.PythonVersion.fromString("3.8"))
  // 你的测试代码逻辑
}

验证版本兼容性 #

• 确认安装的Python版本与ScalaPy依赖版本兼容（如ScalaPy 0.5+支持Python 3.7-3.11），可对照项目依赖的ScalaPy版本核对兼容范围。
• 若使用虚拟环境，需将PYTHONPATH指向虚拟环境的site-packages目录，同时把LD_LIBRARY_PATH指向虚拟环境的lib目录。

检查sbt配置正确性 #

• 确保build.sbt中的ScalaPy依赖配置正确，示例：

  libraryDependencies += "me.shadaj" %% "scalapy-core" % "0.5.1"
  

• 确认plugins.sbt中的插件配置无误：

  addSbtPlugin("me.shadaj" % "sbt-scalapy" % "0.5.1")
  

其他系统适配方案 #

• Windows系统：将Python的DLL目录（如C:\Python38\DLLs）添加到PATH环境变量。
• macOS系统：设置DYLD_LIBRARY_PATH指向Python库目录（如/Library/Frameworks/Python.framework/Versions/3.8/lib）。
• Linux系统：安装Python开发包确保库文件完整，如Ubuntu下执行sudo apt-get install python3-dev。

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