PyInstaller能否打包共享对象文件至可执行文件？路径权限问题求助

核心问题根源 #

你自定义编译的Python、tk/tcl及其他依赖库在编译阶段被硬编码了绝对路径，PyInstaller默认不会修改这些动态库的rpath（运行时库搜索路径），导致程序运行时仍会尝试读取原~/local路径下的库，而其他用户无该目录权限，从而触发Permission denied错误。

可行解决方案 #

方案1：PyInstaller打包+运行时修改rpath

1. 定位依赖库
   用ldd命令找出所有需要打包的自定义路径下的动态库：

   ldd ~/local/lib/python3.10/site-packages/tkinter/_tkinter.cpython-310-x86_64-linux-gnu.so
   

   提取输出中属于~/local/lib的库，比如libtcl8.6.so、libtk8.6.so、libfreetype.so.6、libpng16.so.16等。

2. 带参数打包
   用--add-binary将依赖库加入打包文件，同时指定运行时钩子修改rpath：

   pyinstaller --one-file \
     --add-binary "~/local/lib/libtcl8.6.so:." \
     --add-binary "~/local/lib/libtk8.6.so:." \
     --add-binary "~/local/lib/libfreetype.so.6:." \
     --add-binary "~/local/lib/libpng16.so.16:." \
     --runtime-hook=rpath_hook.py \
     your_script.py
   

3. 编写运行时钩子脚本rpath_hook.py
   该脚本会在程序启动时修改动态库的搜索路径，指向PyInstaller单文件解压的临时目录：

   import os
   import sys
   from ctypes import CDLL, RTLD_GLOBAL, RTLD_NOW
   
   def set_rpath():
       base_path = sys._MEIPASS  # 获取PyInstaller临时解压目录
       target_libs = [
           "libtcl8.6.so",
           "libtk8.6.so",
           "libfreetype.so.6",
           "libpng16.so.16"
       ]
       for lib_name in target_libs:
           lib_path = os.path.join(base_path, lib_name)
           if os.path.exists(lib_path):
               try:
                   # 加载库并设置rpath为当前临时目录
                   CDLL(lib_path, RTLD_NOW | RTLD_GLOBAL)
                   # 调用dlopen确保路径生效
                   CDLL("libdl.so.2", RTLD_GLOBAL).dlopen(lib_path, 0x0001)
               except Exception:
                   pass
   
   set_rpath()
   

方案2：重新编译依赖库时设置相对rpath（根源解决）

如果可以重新编译依赖，在编译阶段直接设置相对路径，后续打包更省心：

• 编译tcl/tk、freetype、libpng等依赖时，在configure阶段添加参数：

  ./configure --prefix=$HOME/local --enable-shared --with-rpath='$ORIGIN'
  

  $ORIGIN表示动态库所在的目录，后续重新编译Python后，用PyInstaller打包时仅需通过--add-binary将依赖库加入，程序运行时会自动搜索同目录下的库。

方案3：用patchelf修改现有库的rpath

不想重新编译的话，用patchelf工具修改已编译库的rpath：

# 先安装patchelf，如Debian/Ubuntu下：apt install patchelf
patchelf --set-rpath '$ORIGIN' ~/local/lib/libtcl8.6.so
patchelf --set-rpath '$ORIGIN' ~/local/lib/libtk8.6.so
# 对其他需要的依赖库执行相同操作

修改完成后再用PyInstaller的--add-binary打包这些库，程序运行时会自动指向临时解压目录中的库文件。

注意事项 #

打包时必须使用你自定义编译的Python环境（确保pyinstaller属于该环境），避免系统Python的配置干扰路径识别。

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