Python调用NetLogo模式抛出RuntimeException问题求助

问题背景 #

使用pyNetLogo连接NetLogo时，代码可正常启动NetLogo GUI，但无法加载模型。该模型单独运行无异常，且已确认JVM路径（/usr/lib/jvm/java-11-openjdk-amd64/lib/server/libjvm.so）正确。

执行代码 #

import pynetlogo

netlogo = pynetlogo.NetLogoLink(
    gui=True,
    netlogo_home="/home/protik/NetLogo/"
)

netlogo.load_model("../Netlogo-model/ICS1023.nlogo")
netlogo.command("setup")

报错信息 #

• Python控制台抛出异常：

Exception                                  
Traceback (most recent call last)
 File NetLogoLink.java:121, in netLogoLink.NetLogoLink.loadModel()
 
Exception: Java Exception
 
 The above exception was the direct cause of the following exception:
 
 java.lang.RuntimeException
Traceback (most recent call last)
 File ~/anaconda3/envs/netlogo-env/lib/python3.8/site-packages/pynetlogo/core.py:246,
   in NetLogoLink.load_model(self, path)
      245 try:
  --> 246     self.link.loadModel(path)
      247 except jpype.JException as ex:
 
 java.lang.RuntimeException: java.lang.RuntimeException
 
 During handling of the above exception, another exception occurred:
 
NetLogoException                           
  Traceback (most recent call last) Cell In[1], line 8
       1 import pynetlogo
       3 netlogo = pynetlogo.NetLogoLink(
       4     gui=True,
       5     netlogo_home="/home/protik/NetLogo/"
       6 )
 ----> 8 netlogo.load_model("../Netlogo-model/ICS1023.nlogo")
       9 netlogo.command("setup")
 
 File ~/anaconda3/envs/netlogo-env/lib/python3.8/site-packages/pynetlogo/core.py:249,
 in NetLogoLink.load_model(self, path)
     247 except jpype.JException as ex:
     248     print(ex.stacktrace())
 --> 249     raise NetLogoException(str(ex))
 
 NetLogoException: java.lang.RuntimeException

• NetLogo界面弹窗提示：

error in loading model java.lang.reflect.invocationtargetexception

解决方案 #

1. 替换为模型绝对路径 #

相对路径可能因Python工作目录与NetLogo启动目录不匹配导致加载失败，直接使用模型的绝对路径：

# 替换为你的模型实际绝对路径
netlogo.load_model("/home/protik/Netlogo-model/ICS1023.nlogo")

2. 检查版本兼容性 #

确保pyNetLogo版本与NetLogo版本匹配：

• NetLogo 6.x 需搭配 pyNetLogo 1.1.0 及以上版本
• NetLogo 5.x 需搭配 pyNetLogo 0.3.x 版本

查看当前pyNetLogo版本：

pip show pynetlogo

版本不兼容时，卸载重装对应版本：

pip uninstall pynetlogo
pip install pynetlogo==1.1.0  # 适配NetLogo 6.x

3. 配置JVM与NetLogo启动参数 #

初始化NetLogoLink时显式指定版本与JVM参数，避免环境变量冲突：

netlogo = pynetlogo.NetLogoLink(
    gui=True,
    netlogo_home="/home/protik/NetLogo/",
    netlogo_version="6.3.0",  # 替换为你的NetLogo实际版本
    jvm_args=["-Xmx2048m"]  # 增加JVM内存分配，解决内存不足问题
)

4. 检查模型扩展依赖 #

若模型使用了NetLogo扩展（如GIS、CSV等），需确保扩展文件存在于NetLogo的extensions目录：

• 确认/home/protik/NetLogo/extensions/下存在模型所需的扩展文件夹
• 自定义扩展需将其路径添加到NetLogo的环境变量中

5. 无GUI模式测试 #

暂时关闭GUI模式，排查是否为GUI交互导致的加载异常：

netlogo = pynetlogo.NetLogoLink(
    gui=False,
    netlogo_home="/home/protik/NetLogo/"
)
netlogo.load_model("/home/protik/Netlogo-model/ICS1023.nlogo")

若无GUI模式可正常加载，再逐步排查GUI相关配置问题。

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