Tomcat是独立运行的Java Web服务器,需先正确配置JDK(JAVA_HOME指向JDK根目录、PATH包含bin),再解压到无中文无空格路径;启动前可修改conf/server.xml中Connector端口;部署应用推荐使用WAR包放入webapps目录。
Tomcat 不是“安装”在 Java 里,而是独立运行的 Java Web 服务器,它依赖 JRE/JDK 运行——你得先配好 Java 环境,再解压/启动 Tomcat,不是用 javac 或 java 命令“装”它。
确认 JDK 已正确配置(JAVA_HOME 和 PATH)
Tomcat 启动脚本(如 startup.bat / startup.sh)会读取 JAVA_HOME。如果报错 The JAVA_HOME environment variable is not defined correctly 或直接闪退,基本就是这一步没走对。
-
JAVA_HOME必须指向 JDK 根目录(不是 JRE,也不是bin子目录),例如:C:\Program Files\Java\jdk-17.0.2(Windows)或/usr/lib/jvm/java-17-openjdk-amd64(Linux/macOS) -
PATH需包含%JAVA_HOME%\bin(Windows)或$JAVA_HOME/bin(macOS/Linux),否则java -version可能报 command not found - 终端新开一个窗口后执行
echo %JAVA_HOME%(Windows)或echo $JAVA_HOME(macOS/Linux),再跑java -version和javac -version,两个输出版本号必须一致且非空
下载、解压、不“安装”——Tomcat 是绿色免安装版
Apache 官网只提供 zip/tar.gz 归档包,没有 Windows Installer 或 macOS pkg。所谓“安装”,其实就是解压到无中文、无空格路径下,比如 D:\tomcat 或 ~/apache-tomcat-10.1.22。
- 别解压到
C:\Program Files\(Windows 权限问题易导致日志写入失败) - 别放在桌面或用户目录下带空格的路径(如
C:\Users\John Doe\Downloads\),startup.bat会解析失败 - 解压后检查
bin目录下是否有startup.bat(Windows)或startup.sh(macOS/Linux),以及conf/server.xml是否可读
启动前改端口?先看 conf/server.xml 里的 Connector
默认 8080 端口被占用时,Tomcat 启动成功但访问 http://localhost:8080 显示连接被拒绝——其实服务根本没起来,错误藏在 logs/catalina.out 或命令行输出里。