JDK 选择与安装
校对日期:2026-11-16。适用于社区版及全部商业版。使用 Docker 部署时镜像已自带 Java 运行环境,可跳过本页。
UJCMS 需要 JDK 17 或 21。本页说明选哪个发行版、在 Windows 和 Linux 上怎样安装;下文的命令和截图以 17 为例, 安装 21 时把其中的版本号换掉即可。
一、选择 JDK
JDK 有多个发行版,都基于 OpenJDK 的源代码,区别在于谁来提供构建、更新和长期维护。
- 推荐使用 Adoptium 发行的 Eclipse Temurin,可免费用于生产环境。 官方下载:https://adoptium.net/;国内可以从清华大学镜像站下载:https://mirrors.tuna.tsinghua.edu.cn/Adoptium/。
- Oracle JDK 的许可条款对商业使用有限制,使用前请先确认授权。
下载时按下面几项选择:
| 选项 | 选择 | 说明 |
|---|---|---|
| 版本 | 17 或 21 | 两者都是长期支持版本 |
| 类型 | JDK | 不要选 JRE:JRE 只有运行环境,缺少部分工具 |
| CPU 架构 | 一般为 x64 | ARM 服务器(鲲鹏、飞腾等)选 aarch64 |
| 操作系统 | Windows / Linux / macOS | |
| 包格式 | 压缩包(.zip / .tar.gz) | 解压即用,同一台机器上可以放多个版本,切换方便 |
二、Windows 安装
下载。打开清华大学镜像站的 Windows 目录 https://mirrors.tuna.tsinghua.edu.cn/Adoptium/17/jdk/x64/windows/, 下载其中的
.zip文件。
解压到不含中文和空格的目录,如
D:\java\jdk17。解压后该目录下应直接是bin、conf、lib等文件夹。打开环境变量设置。在开始菜单中搜索“环境变量”,选择 编辑系统环境变量,在弹出的窗口中点击 环境变量。
新建
JAVA_HOME。在“系统变量”下点击 新建,变量名填JAVA_HOME,变量值填 JDK 的解压目录。
把
java命令加入Path。在“系统变量”中选中Path,点击 编辑 → 新建,填入%JAVA_HOME%\bin。
逐级点击 确定 关闭各个窗口,否则设置不会保存。
验证。重新打开一个命令行窗口(PowerShell 或 cmd,已经打开的窗口读不到新的环境变量),执行
java -version, 能看到版本信息即安装成功。
三、Linux 安装
以下命令以 x64 架构、安装到 /opt/java/jdk17 为例,需要 root 权限。
检查系统里是否已有 JDK:
bashjava -version已经是 17 或 21 的可以直接使用。版本不符时,可以先卸载系统自带的 OpenJDK(以使用
dnf的发行版为例):bashdnf list installed | grep openjdk # 查找已安装的 OpenJDK dnf remove <上一步列出的包名> # 卸载也可以用
dnf search openjdk看看系统软件源里有没有 17 或 21,有的话直接用dnf install安装,不必再做下面几步。下载。打开 https://mirrors.tuna.tsinghua.edu.cn/Adoptium/17/jdk/x64/linux/,复制其中
.tar.gz文件的地址后用wget下载。 镜像站只保留最新的小版本,文件名会随版本更新变化,以页面上的实际文件名为准:bashwget https://mirrors.tuna.tsinghua.edu.cn/Adoptium/17/jdk/x64/linux/<文件名>.tar.gz解压并改成固定的目录名,以后升级小版本时不用再改环境变量:
bashmkdir -p /opt/java tar -zxvf <文件名>.tar.gz -C /opt/java mv /opt/java/jdk-17.* /opt/java/jdk17设置环境变量。在
/etc/profile末尾加上两行,然后执行source /使其生效:etc/ profile bashexport JAVA_HOME=/opt/java/jdk17 export PATH=$JAVA_HOME/bin:$PATH验证。执行
java -version,输出类似下面的内容即安装成功:textopenjdk version "17.0.14" 2025-01-21 OpenJDK Runtime Environment Temurin-17.0.14+7 (build 17.0.14+7) OpenJDK 64-Bit Server VM Temurin-17.0.14+7 (build 17.0.14+7, mixed mode, sharing)
四、国产 CPU 平台
- 海光、兆芯(x86 架构)和 鲲鹏、飞腾(ARM 架构):有社区版 OpenJDK,按上文安装,注意选对 CPU 架构。
- 龙芯(LoongArch)和 申威:没有社区版 OpenJDK,需要使用各自厂商提供的 JDK:
国产操作系统自带的软件源里不一定有符合要求的版本(以下为 2025 年 3 月的情况,以系统实际为准),没有时按上文手动安装:
| 操作系统 | 软件源里的 JDK |
|---|---|
| 银河麒麟高级服务器操作系统 V10 | 11,不满足要求 |
| 统信服务器操作系统 V20(1xxxe,基于 openEuler) | 11,不满足要求 |
| 统信服务器操作系统 V20(1xxxa,基于 OpenAnolis) | 17,可以直接用 dnf 安装 |
五、常见问题
java -version提示找不到命令,或显示的还是旧版本。 环境变量没有生效:Windows 需要重新打开命令行窗口; Linux 需要执行source /或重新登录。仍是旧版本时,检查etc/ profile PATH中是否有另一个 JDK 排在前面。- 只装了 JRE 可以吗? 请安装 JDK。部分应用服务器(如东方通 TongWeb)在只有 JRE 时有功能无法使用。
- 用 Tomcat 部署时 JDK 怎么指定? Tomcat 读取
JAVA_HOME环境变量,按本页设置后无需另行配置。