使用PyInstaller打包Python脚本为exe后出现tabula jar包访问错误

这个问题我帮不少开发者排查过——核心原因是PyInstaller单文件打包时没有自动包含tabula-py依赖的Jar文件，而且单文件模式下程序运行时会解压到系统临时目录，脚本里的Jar路径没有适配这个临时环境，导致运行时找不到文件。

下面是亲测有效的解决步骤：

第一步：找到tabula-py的Jar文件路径 #

先在你的Python开发环境里运行这段代码，获取Jar文件的绝对路径：

import tabula
print(tabula.io.find_jar())

运行后会输出类似C:\Users\YourName\AppData\Local\Programs\Python\Python39\Lib\site-packages\tabula\tabula-1.0.2-jar-with-dependencies.jar的路径，把这个路径记下来。

第二步：修改Python脚本，适配打包后的环境 #

修改你的脚本，添加一个函数来动态获取Jar文件的路径，确保打包后能找到临时目录里的Jar：

import sys
import os
import tabula

def get_tabula_jar_path():
    # 判断是否是PyInstaller打包后的运行环境
    if getattr(sys, 'frozen', False):
        # 打包后程序会解压到sys._MEIPASS临时目录，这里指定Jar的位置
        return os.path.join(sys._MEIPASS, 'tabula-1.0.2-jar-with-dependencies.jar')
    else:
        # 正常开发环境，用tabula自带的Jar路径
        return tabula.io.find_jar()

# 调用tabula方法时，手动指定jar_path参数
df = tabula.read_pdf('your_target_pdf.pdf', jar_path=get_tabula_jar_path())
# 你的其他业务代码...

第三步：用PyInstaller打包时包含Jar文件 #

有两种方式可以把Jar文件加入打包包：

方式1：直接用命令行参数打包 #

在命令行里运行（把第一步得到的Jar路径替换进去，Windows用分号分隔路径，macOS/Linux用冒号）：

# Windows系统
pyinstaller --onefile --add-data "C:\你的Jar文件绝对路径;." script.py

# macOS/Linux系统
pyinstaller --onefile --add-data "/你的Jar文件绝对路径:." script.py

方式2：通过spec文件打包（更灵活） #

1. 先生成默认的spec文件：

pyinstaller --onefile script.py

2. 打开生成的script.spec文件，找到Analysis里的datas参数，添加Jar文件的路径映射：

a = Analysis(
    ['script.py'],
    datas=[('C:\你的Jar文件绝对路径', '.')],  # 把这里的路径换成你的Jar路径
    # 其他原有内容保持不变...
)

3. 用spec文件重新打包：

pyinstaller script.spec

为什么会出现这个问题？ #

直接运行脚本时，tabula-py会自动在它的安装目录下查找依赖的Jar文件；但PyInstaller单文件打包时，只会收集Python相关的依赖文件，默认不会识别并包含第三方库的非Python资源（比如这个Jar文件）。而且单文件exe运行时会把所有内容解压到一个临时目录（sys._MEIPASS），如果脚本里没有适配这个路径，就会找不到Jar文件。

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