Linux下如何通过JPype正确启动并初始化JVM？

报错原因 #

你遇到的ImportError: Attempt to create Java package 'com' without jvm，本质是在JVM启动完成前就尝试导入了依赖Java的Python包（比如Aspose.Cells的com相关模块），而非单纯的JVM路径配置错误。

正确的JVM初始化步骤及代码 #

核心原则：先启动JVM，再导入任何依赖Java的模块

以下是两种可靠的初始化方式：

1. 通过JAVA_HOME环境变量启动JVM

import os
import jpype

# 先设置正确的JAVA_HOME路径，确保目录存在
os.environ["JAVA_HOME"] = "/usr/lib/jvm/java-11-openjdk-amd64"
# 调用getDefaultJVMPath()自动获取JVM库路径，可添加JVM参数（如堆内存设置）
jpype.startJVM(jpype.getDefaultJVMPath(), "-Xmx1024m")

# JVM启动后，再导入Aspose.Cells模块
from asposecells.api import Workbook

# 后续业务代码
workbook = Workbook()
# ...

2. 直接指定JVM库文件路径启动

import jpype

# 直接传入libjvm.so的完整绝对路径，确保文件存在
jpype.startJVM("/usr/lib/jvm/java-11-openjdk-amd64/lib/server/libjvm.so", "-Xmx1024m")

# 启动后再导入Aspose相关模块
from asposecells.api import Workbook

# 后续业务代码
# ...

常见排查点 #

• 验证JDK路径有效性：执行ls /usr/lib/jvm/java-11-openjdk-amd64/lib/server/libjvm.so，确认文件存在且当前用户有读取权限。
• JDK版本兼容性：Aspose.Cells for Python推荐使用JDK 8或11，避免使用过高或过低版本的JDK。
• JPype版本匹配：确保安装的JPype版本符合Aspose要求（建议jpype1>=1.3.0），可通过pip show jpype1查看版本。
• 代码顺序检查：严格禁止在jpype.startJVM()之前导入asposecells或任何依赖Java的模块，这是触发该错误的最常见原因。

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