必须使用 IDEA Ultimate 版并启用 Tomcat and TomEE 插件，TOMCAT_HOME 指向解压根目录，开发首选 war exploded 部署，404 需依次检查日志部署、端口、web.xml 映射及日志显示设置。
IDEA 里点 Run/Debug Configuration 没反应？先确认 Tomcat Server 插件已启用
IntelliJ IDEA 默认不自动激活 Tomcat 支持，尤其社区版根本没这个功能——别折腾了，用专业版（Ultimate）是硬性前提。即使你装了插件，也得手动打开：Settings → Plugins → 搜索 “Tomcat and TomEE” → 勾选启用。重启 IDEA 后，Run → Edit Configurations… 才会出现 + → Tomcat Server → Local 选项。
常见错误现象：点了 + → Tomcat Server，列表为空或报错 No Tomcat server configuration found，大概率是插件没启、版本不匹配（比如用了 IDEA 2023.3 却装了旧版插件），或误装了第三方“Tomcat Runner”类插件（冲突）。
配置 Tomcat Home 路径时，为什么不能选 bin 目录？
TOMCAT_HOME 必须指向解压后的根目录（如 /opt/tomcat 或 C:\apache-tomcat-10.1.22），不是 bin，也不是 webapps。IDEA 会从该路径下读取 conf/server.xml、调用 bin/catalina.sh（Linux/macOS）或 bin/catalina.bat（Windows）启动服务。选错会导致启动失败，错误日志里常出现 Cannot find catalina.jar 或 Failed to load class org.apache.catalina.startup.Bootstrap。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 下载官方二进制分发包（
tar.gz或zip），别用系统包管理器（如apt install tomcat10）安装的版本——路径结构不标准，IDEA 识别不了 - 路径中避免中文、空格、特殊符号；Windows 下尽量不用
C:\Program Files\这类带空格路径 - 如果用 JDK 17+，务必选 Tomcat 10.1+（支持 Jakarta EE 9+），否则部署时会报
java.lang.NoClassDefFoundError: javax/servlet/Filter
部署 Artifact 时选 “Exploded” 还是 “WAR file”？
开发阶段一律选 exploded（即解压模式）。它把编译后的 .class、WEB-INF/web.xml、静态资源等直接复制到 tomcat/webapps/yourapp/ 下，改完 Java 类或 JSP 后点 Ctrl+F9 编译，再点 Reload page（或 IDEA 自动触发 Update resources）就能生效，无需重启 Tomcat。
选 WAR file 只适合打包交付，开发中每次改代码都要重新生成 WAR、解压、再部署，效率极低。而且 IDEA 对 WAR 部署的热更新支持非常弱，改了类基本等于白改。
注意两个关键配置点：
-
Application context建议显式填成/或/myapp，别留空——否则默认上下文路径是项目名，容易和实际访问路径不一致 - 确保
Artifact类型是war exploded，不是jar或javaee application exploded；在Project Structure → Artifacts里检查输出布局是否含WEB-INF/classes和WEB-INF/lib
启动后页面 404，但 Tomcat 控制台没报错？重点查三个地方
这种静默失败最常见于路径映射断层。IDEA 部署的是“虚拟应用”，不等于你手动把 WAR 丢进 webapps 目录。它走的是内部 HTTP connector + 内存中部署流程，中间环节多了一层抽象。
排查顺序：
- 看 IDEA 控制台输出的启动日志末尾有没有类似
Deploying web application directory [/path/to/tomcat/webapps/yourapp]—— 如果没有，说明 Artifact 根本没挂上，回退检查上一步的 Artifact 配置 - 浏览器访问
http://localhost:8080/看 Tomcat 默认页是否出来；如果连这个都打不开，说明端口被占（Address already in use: bind）或server.xml的Connector port="8080"被改过，且 IDEA 配置里的HTTP port没同步改 - 确认
web.xml中的<servlet-mapping></servlet-mapping>和实际请求路径匹配；Spring Boot 项目若混用传统 Web.xml，容易因 servlet 容器初始化顺序导致 DispatcherServlet 未注册
复杂点在于：IDEA 的 Tomcat 运行实例是独立进程，它的 catalina.out 日志默认不显示在控制台，需手动勾选 Build and run → Logs → Show console when a message is printed to stdout/stderr，否则很多关键错误就藏在后台文件里，看不见。
