macOS下tabula-py调用read_pdf报AttributeError问题求助

问题原因 #

你遇到的问题大概率是旧的tabula包（非tabula-py）没有彻底卸载干净，导致Python导入的还是不包含read_pdf方法的旧模块；或者Python环境存在冲突，安装的tabula-py没有被当前运行环境加载。

解决步骤 #

1. 彻底清理所有tabula相关包 #

先卸载已安装的tabula和tabula-py：

pip uninstall -y tabula tabula-py

然后检查是否还有残留：

pip list | grep -E "tabula|tabula-py"

如果输出有相关包，重复卸载命令直到完全清除。

2. 手动清理残留文件（可选但推荐） #

macOS下，找到Python的site-packages目录（比如系统Python的/Library/Python/3.9/site-packages，或者虚拟环境下的venv/lib/pythonX.Y/site-packages），删除所有名称包含tabula或tabula_py的文件夹和.egg-info文件。

3. 重新安装tabula-py #

使用pip安装最新版：

pip install tabula-py

安装完成后验证：

pip show tabula-py

确认输出的Location路径和当前Python环境的site-packages一致。

4. 验证Java环境配置 #

brew安装的Java可能需要手动链接到系统路径，确保Java可被全局调用：

sudo ln -sfn /usr/local/opt/openjdk/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk.jdk

验证Java版本：

java -version

确保输出你安装的1.8.0_381版本信息。

5. 测试代码 #

在Python交互环境中运行以下代码验证：

import tabula
# 查看模块的所有可用属性，确认包含read_pdf
print(dir(tabula))
# 测试读取PDF（替换为你的文件路径）
df = tabula.read_pdf("test.pdf")
print(df)

如果还是报错，检查当前Python环境和pip是否匹配：

which python
which pip

两者路径应该属于同一个环境（比如虚拟环境的venv/bin/python和venv/bin/pip），如果不一致，切换到对应环境后重新安装。

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