Tomcat启动失败主因是JAVA_HOME未正确配置或JDK版本不匹配；需设JAVA_HOME指向JDK根目录、验证java/javac版本、配置URIEncoding="UTF-8"解决中文乱码，并通过IDE正确部署Artifact。
Tomcat 启动失败：找不到 JAVA_HOME 或报错 “Neither the JAVA_HOME nor the JRE_HOME environment variable is defined”
这是最常见配置错误，本质是 Tomcat 启动脚本（catalina.bat 或 catalina.sh）无法定位 JDK。Tomcat 10+ 强制要求 JDK 11+，且必须是完整 JDK（不能只配 JRE）。
- 确认已安装 JDK（非 JRE），执行
java -version和javac -version均应有输出 - 设置系统环境变量：
JAVA_HOME指向 JDK 根目录（如C:\Program Files\Java\jdk-17.0.2或/usr/lib/jvm/java-17-openjdk-amd64），不要带\bin - Windows 下还需把
%JAVA_HOME%\bin加入PATH；Linux/macOS 下建议在~/.bashrc或~/.zshrc中追加export PATH=$JAVA_HOME/bin:$PATH - 重启终端或命令行窗口再运行
startup.bat/startup.sh
IDEA/Eclipse 中部署 Web 应用时提示 “Artifact not configured” 或 404
这不是 Tomcat 配置问题，而是 IDE 未将项目正确构建成可部署的 WAR 结构，或未关联到 Tomcat 实例。
- 检查项目是否启用
Web ApplicationFacet（IntelliJ：Project Structure → Modules → + → Web；Eclipse：Project Properties → Project Facets → Dynamic Web Module） - 确认
Artifacts已定义：IntelliJ 中打开 Project Structure → Artifacts → + → Web Application: Archive → 选中输出路径和WEB-INF/classes、lib等内容 - 在 Run Configuration 中选择正确的 Tomcat Server，并在
Deployment标签页点击 + →Artifact→ 选中你刚配置的 WAR 或 exploded artifact - 避免直接复制
target/xxx.war到webapps/后启动——IDE 会覆盖或忽略该文件，应始终通过 IDE 的 Deploy 流程触发
修改 server.xml 后 Tomcat 不生效或启动卡住
conf/server.xml 是核心配置文件，但随意改动端口、Connector 或 Host 容易引发冲突或语法错误，导致静默失败。
- 改端口前先用
netstat -ano | findstr :8080（Windows）或lsof -i :8080（macOS/Linux）确认端口空闲 - 修改
<Connector port="8080" ...>后，务必检查是否有重复的port值，或误删了protocol="HTTP/1.1"属性（会导致启动无响应） - 新增
<Host>时，name必须与 DNS 可解析域名一致（开发环境建议用localhost），且appBase路径需存在并有读写权限 - 每次修改后清空
work/Catalina/和logs/下旧日志，避免缓存干扰；启动时紧盯catalina.out（Linux/macOS）或catalina.[date].log（Windows）中的 ERROR 行
WAR 包部署后中文路径/参数乱码（如 URL 中中文变 %E4%BD%A0%E5%A5%BD，但页面显示为 “ä½ å¥½”）
根本原因是 Tomcat 默认使用 ISO-8859-1 解码 URI，而浏览器实际发送的是 UTF-8 编码字节。需显式指定编码规则。
立即学习“Java免费学习笔记（深入）”；
- 在
conf/server.xml的<Connector>标签中添加属性：URIEncoding="UTF-8"（例如：<Connector port="8080" protocol="HTTP/1.1" URIEncoding="UTF-8" />） - 若用 Spring Boot 内嵌 Tomcat，则在
application.properties中设：server.tomcat.uri-encoding=UTF-8 - 注意：此配置仅影响 URI 解码，
request.setCharacterEncoding("UTF-8")仍需在 Servlet 或 Filter 中调用，用于处理 POST 表单体编码 -
前端 HTML 必须声明
<meta charset="UTF-8">，否则浏览器可能按系统默认编码渲染
## 示例：修正后的 minimal Connector 配置（server.xml）
<Connector port="8080"
protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443"
URIEncoding="UTF-8" />Tomcat 环境配置真正难的不是步骤，而是每一步背后隐含的约束条件：JDK 版本与 Tomcat 大版本的对应关系、IDE 构建产物与 Tomcat 部署路径的映射逻辑、XML 配置项之间的依赖性。漏掉任意一个前提，都会让“配置完成”变成“看似启动成功实则不可用”。
