Tomcat 9 配置指定 JDK 版本方法

Tomcat 9 配置指定 JDK 版本方法

将解压版 JDK 部署至 Tomcat 9 根目录（CATALINA_HOME）下，通过相对路径配置专属 JDK 环境，实现 Tomcat-JDK 一体化。核心是利用 Tomcat 官方推荐的 setenv 脚本配置 JAVA_HOME。

第一步：标准化目录结构

整理 Tomcat 9 目录，将解压版 JDK 放入 Tomcat 根目录下的 jdk 子文件夹。

apache-tomcat-9.0.XX/ # Tomcat 9 根目录（即 CATALINA_HOME）
├─ bin/               # Tomcat 启动/停止脚本目录
├─ conf/              # 配置文件
├─ webapps/           # 项目部署目录
├─ jdk/               # 新建的 JDK 存放目录
│  └─ jdk1.8.0_391/   # 解压后的 JDK 完整目录
├─ logs/              # 日志
└─ temp/              # 临时文件

注意：JDK 目录名可自定义，但后续配置需对应，禁止包含中文、空格或特殊字符。

第二步：核心配置

Tomcat 启动时会自动加载 bin 目录下的 setenv.bat（Windows）或 setenv.sh（Linux/Mac）。该文件默认不存在，需手动新建。

场景 1：Windows 系统

1. 在 bin 目录下新建文本文件，重命名为 setenv.bat。
2. 编辑文件，写入以下内容：

@echo off
:: 基于 CATALINA_HOME 配置相对路径的 JAVA_HOME
set "JAVA_HOME=%CATALINA_HOME%\jdk\jdk1.8.0_391"
:: 可选：设置 JVM 运行参数
set "JAVA_OPTS=-Xms512m -Xmx1024m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=256m"

替换 jdk1.8.0_391 为实际 JDK 目录名。

场景 2：Linux/Mac 系统

1. 在 bin 目录下新建 setenv.sh 文件：

touch "$CATALINA_HOME/bin/setenv.sh"

2. 编辑 setenv.sh，写入以下内容：

#!/bin/sh
# 基于 CATALINA_HOME 配置相对路径的 JAVA_HOME
export JAVA_HOME=$CATALINA_HOME/jdk/jdk1.8.0_391
# 可选：JVM 运行参数
export JAVA_OPTS="-Xms512m -Xmx1024m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=256m"

3. 添加执行权限：

chmod +x "$CATALINA_HOME/bin/setenv.sh"

第三步：测试启动与验证

无需配置系统全局 JAVA_HOME，直接启动 Tomcat。

Windows

cd "%CATALINA_HOME%\bin"
startup.bat

Linux/Mac

cd "$CATALINA_HOME/bin"
./startup.sh

查看日志验证 JDK 是否生效（搜索 Java Home）：

grep "Java Home" "$CATALINA_HOME/logs/catalina.out"

正确输出示例：

Java Home: /opt/apache-tomcat-9.0.90/jdk/jdk1.8.0_391/jre

关键避坑点

1. JDK 必须是解压版：安装版会写入系统注册表，无法通过相对路径独立使用。
2. 禁止修改原生脚本：不要直接改 catalina.bat/sh，升级时会被覆盖，setenv 是官方预留入口。
3. 无中文/空格路径：Tomcat 根目录及 JDK 目录全程禁止中文、空格、特殊字符。
4. 相对路径基于 CATALINA_HOME：使用 %CATALINA_HOME% 或 $CATALINA_HOME，避免在非 Tomcat 目录启动时路径失效。
5. Tomcat 9 的 JDK 兼容：最低支持 JDK 8，推荐 JDK 8/JDK 11。

关于 setclasspath.sh 的说明

若发现 bin 目录中有 setclasspath.sh（Linux/Mac）或 setclasspath.bat（Windows），这是 Tomcat 原生的核心脚本，作用是检测并设置 JDK/JRE 的类路径。无需修改此文件，我们的 setenv.sh 配置会被其优先读取。

加载顺序

Tomcat 启动脚本执行流程如下（以 Linux 为例）：

startup.sh → catalina.sh → setenv.sh（自定义，优先加载）→ setclasspath.sh（原生，检测 JDK）→ 启动 Tomcat

验证配置

可直接执行 setclasspath.sh 快速验证 JDK 配置是否正确：

cd "$CATALINA_HOME/bin"
./setclasspath.sh

• 配置成功：无任何报错，直接返回命令行。
• 配置失败：会明确报错 JAVA_HOME is not defined correctly。

总结

1. 目录结构：Tomcat 根目录下新建 jdk 文件夹，放入解压版 JDK。
2. 专属配置：在 bin 目录新建 setenv.bat/sh，利用 CATALINA_HOME 配置相对路径 JAVA_HOME。
3. 跨目录启动：基于内置变量，确保路径在任何目录执行脚本时均有效。
4. 升级友好：setenv 文件不会被 Tomcat 升级覆盖，更换 JDK 只需修改该文件。

完成上述配置即可实现 Tomcat-JDK 一体化，直接拷贝整个 Tomcat 目录到其他同系统服务器即可直接使用。