最可靠方式是IDE内置Tomcat Server配置调试：IDEA选“Tomcat Server→Local”并指定解压目录，Eclipse在Servers视图配本地Runtime；必须用exploded部署、确保JDWP参数注入成功（日志含-agentlib:jdwp），避免Maven插件。
IntelliJ IDEA 或 Eclipse 调试 Java Web 应用时，直接启动 Tomcat 并附加调试器是最可靠的方式；用 Maven 插件（如 tomcat7-maven-plugin）跑起来的进程默认不支持远程调试，且无法设置断点或查看 Servlet 容器内部状态。
IDEA 中配置 Local Tomcat Server（非 Maven 插件）
必须使用「Tomcat Server」运行配置类型，而非「Application」或「Maven」。IDEA 会自动注入 -agentlib:jdwp 参数并监听 localhost:8000（可改），同时部署 war 或 exploded 目录。
- Run → Edit Configurations → + → Tomcat Server → Local
- Application server 选已下载解压的 Tomcat 根目录（不是
tomcat-home/lib，也不是 Maven 仓库里的 jar） - Deployment → + → Artifact → 选你的
war exploded（不是war，否则修改 JSP/HTML 后需重打包） - Startup script 不要填：IDEA 自己管理
bin/startup.sh或bin/startup.bat - 确认 VM options 里没手动加
-Dcom.sun.management.jmxremote等干扰参数
Eclipse 中配置 Server Runtime Environment
Eclipse 的「Servers」视图本质是把 Tomcat 当作外部进程托管，调试依赖 JVM 的 JDWP 协议，但默认启用——只要没在 catalina.sh 或 server.xml 里禁用 debug 模式。
- Window → Show View → Servers → 右键 → New → Server → Apache → Tomcat v9.0 Server
- Runtime Environment 必须指向本地解压路径（
/opt/tomcat或C:\apache-tomcat-9.0.x），不能是 Maven 依赖 - 右键 Server → Properties → Ports：确认 Debug port 是
8000（与 IDEA 默认一致，避免冲突） - 双击 Server 打开配置页 → Open launch configuration → Arguments → VM arguments：检查是否含
-agentlib:jdwp=transport=dt_socket...（IDE 自动生成，勿删） - 项目必须为 Dynamic Web Project，且 Target runtime 已绑定该 Tomcat
常见调试失败原因与验证方式
断点不生效、连接被拒绝、热更新失败，往往不是代码问题，而是环境链路中断。
立即学习“Java免费学习笔记（深入）”；
-
Connection refused：Tomcat 没真正启动，或 IDEA/Eclipse 的 Debug port 被占用（用lsof -i :8000或netstat -ano | findstr :8000查） - 断点灰掉（unavailable）：模块未正确部署为 exploded 形式；或源码版本与 class 文件不匹配（clean 重建 artifact）
- 修改 JSP 后刷新无变化：确认 IDEA/Eclipse 的
On 'Update' action设为Update resources，且 Tomcat 的reloadable="true"在context.xml中启用 - 控制台无
Listening for transport dt_socket日志：说明 JDWP agent 未加载，检查 IDE 运行配置中是否误勾了Enable debug output但关闭了实际调试开关
22-May-2024 10:23:45.123 INFO [main] org.apache.catalina.startup.VersionLoggerListener.log Server version name: Apache Tomcat/9.0.86 22-May-2024 10:23:45.125 INFO [main] org.apache.catalina.startup.VersionLoggerListener.log Server built: Jan 23 2024 10:07:16 UTC 22-May-2024 10:23:45.125 INFO [main] org.apache.catalina.startup.VersionLoggerListener.log Server number: 9.0.86.0 22-May-2024 10:23:45.126 INFO [main] org.apache.catalina.startup.VersionLoggerListener.log OS Name: Linux 22-May-2024 10:23:45.126 INFO [main] org.apache.catalina.startup.VersionLoggerListener.log OS Version: 5.15.0-101-generic 22-May-2024 10:23:45.127 INFO [main] org.apache.catalina.startup.VersionLoggerListener.log Architecture: amd64 22-May-2024 10:23:45.127 INFO [main] org.apache.catalina.startup.VersionLoggerListener.log Java Home: /usr/lib/jvm/java-11-openjdk-amd64 22-May-2024 10:23:45.128 INFO [main] org.apache.catalina.startup.VersionLoggerListener.log JVM Version: 11.0.22+7-post-Ubuntu-0ubuntu222.04.1 22-May-2024 10:23:45.128 INFO [main] org.apache.catalina.startup.VersionLoggerListener.log JVM Vendor: Ubuntu 22-May-2024 10:23:45.129 INFO [main] org.apache.catalina.startup.VersionLoggerListener.log CATALINA_BASE: /home/user/Projects/tomcat-debug 22-May-2024 10:23:45.129 INFO [main] org.apache.catalina.startup.VersionLoggerListener.log CATALINA_HOME: /opt/tomcat 22-May-2024 10:23:45.130 INFO [main] org.apache.catalina.startup.VersionLoggerListener.log Command line argument: -agentlib:jdwp=transport=dt_socket,address=localhost:8000,server=y,suspend=n 22-May-2024 10:23:45.130 INFO [main] org.apache.catalina.startup.VersionLoggerListener.log Command line argument: -Djava.endorsed.dirs= ...
关键看最后一行是否出现 -agentlib:jdwp=...；没有就说明 IDE 没成功注入调试参数，得回头检查 Server 配置是否用了「Local」模式、是否绑定了正确的 Tomcat 实例目录。
