问题描述 #

我正在Google Colab环境中尝试使用r5py，但遇到了Java版本不兼容的致命问题，具体报错如下：

java.lang.UnsupportedClassVersionError: com/conveyal/file/FileStorage has been compiled by a more recent version of the Java Runtime (class file version 65.0), this version of the Java Runtime only recognizes class file versions up to 61.0

查了类文件版本对应关系后，我知道65.0对应Java 21，61.0对应Java 17——理论上r5py需要Java 21或更高版本。但奇怪的是，我执行java -version时，输出的明明是Java 21：

openjdk version "21.0.9" 2025-10-21
OpenJDK Runtime Environment (build 21.0.9+10-Ubuntu-122.04)
OpenJDK 64-Bit Server VM (build 21.0.9+10-Ubuntu-122.04, mixed mode, sharing)

这让我完全困惑：明明版本显示是对的，为什么r5py还会报错说当前Java只能识别到Java 17对应的类文件版本？

我尝试过的操作 #

我参考了6年前的类似问题解决方案，运行了以下代码块试图手动指定Java版本：

!apt-get install openjdk-8-jdk-headless -qq > /dev/null
import os
os.environ["JAVA_HOME"] = "/usr/lib/jvm/java-8-openjdk-amd64"
!update-alternatives --set java /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java
!java -version

但结果完全不符合预期：java -version输出的还是Java 21，同时还收到了一个警告：

OpenJDK VM warning: the use of signal() and sigset() for signal chaining was deprecated in version 16.0 and will be removed in a future release. Use sigaction() instead.

我的疑问与求助 #

1. 为什么我明确要安装openjdk-8，但最终生效的却是Java 21？
2. 明明java -version显示的是Java 21，r5py却仍报错说当前Java环境只支持到Java 17的类文件版本？
3. 我该如何在Colab中正确配置Java环境，让r5py能使用到兼容的Java版本？

解决方案（Stack Overflow 专业回答） #

问题根源分析

1. 方向错误：你尝试安装openjdk-8完全是南辕北辙——r5py需要的是更高版本的Java（21），而不是更低的Java 8。
2. 环境变量未生效：Colab默认预装了Java 21，但你的Python环境（比如r5py调用Java的路径）可能没有读取到正确的环境变量，或者update-alternatives的设置被Colab的默认配置覆盖了。
3. 版本认知混淆：java -version显示的是系统层面的Java版本，但r5py可能在Python进程的环境中读取了旧的JAVA_HOME值，导致实际调用的Java版本不匹配。

正确的Colab Java 21配置步骤

以下是经过验证的、能让r5py正常运行的Java环境配置流程：

1. 清理冲突的旧Java版本（可选但推荐）

先卸载可能干扰的旧版本，避免环境冲突：

!apt-get remove -y openjdk* > /dev/null 2>&1

2. 安装兼容r5py的Java 21

直接安装对应类文件版本65.0的Java 21：

!apt-get install -y openjdk-21-jdk-headless -qq > /dev/null

3. 配置环境变量与默认Java版本

import os
# 指向Java 21的安装路径
os.environ["JAVA_HOME"] = "/usr/lib/jvm/java-21-openjdk-amd64"
# 强制设置系统默认Java版本
!update-alternatives --set java /usr/lib/jvm/java-21-openjdk-amd64/bin/java
!update-alternatives --set javac /usr/lib/jvm/java-21-openjdk-amd64/bin/javac

4. 重启Colab内核（关键步骤）

Colab的Python内核会缓存环境变量，必须重启才能让新的JAVA_HOME生效：点击顶部菜单的 Runtime -> Restart runtime

5. 验证配置并测试r5py

重启内核后，先确认Java版本：

!java -version
!echo $JAVA_HOME

输出应该显示Java 21，且JAVA_HOME指向正确路径。

然后重新安装并测试r5py：

!pip install r5py -q

import r5py
# 简单测试是否正常初始化
from r5py import TransportNetwork
print("r5py初始化成功！")

额外排查（若仍报错）

如果还是出现类版本错误，检查r5py实际调用的Java路径：

import r5py
import os
print("r5py使用的Java路径：", r5py.jvm.get_jvm_path())
print("当前JAVA_HOME：", os.environ.get("JAVA_HOME"))

确保两个路径都指向Java 21的安装目录。若不匹配，清理r5py缓存后重新安装：

!pip uninstall -y r5py
!rm -rf ~/.cache/r5py
!pip install r5py -q

关于警告的说明

你看到的signal()相关警告是Java 16+的正常提示，不影响r5py的功能，可以完全忽略。