优先用CATALINA_OPTS，它通用可控且仅作用于Tomcat；JPDA_OPTS仅在jpda start命令下生效，易因忽略JPDA_ADDRESS等变量导致连不上；JAVA_OPTS应避免使用，以免影响其他JVM进程。
JPDA_OPTS 和 CATALINA_OPTS 选哪个？
优先用 CATALINA_OPTS，别碰 JPDA_OPTS。虽然 Tomcat 文档里提了 JPDA_OPTS，但它只在 catalina.sh jpda start 这种特定命令下才生效，而且一旦你手动设置了 JPDA_OPTS，Tomcat 就会忽略 JPDA_ADDRESS、JPDA_TRANSPORT 等变量——容易导致端口配错却没报错，连不上还查不出原因。
CATALINA_OPTS 是更通用、更可控的方式：它直接注入 JVM 启动参数，不依赖启动脚本分支逻辑，且只影响 Tomcat 自身进程。
- 用
CATALINA_OPTS时，必须写完整 JDWP 参数，比如：-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 - 不要混用
JPDA_OPTS和CATALINA_OPTS，否则行为不可预测 - 绝对避免用
JAVA_OPTS，它会影响同一 JVM 下所有 Java 进程（比如你部署了多个应用或启用了其他工具）
address=5005 为什么连不上？
常见原因是 address 值写成了 localhost:5005 或 127.0.0.1:5005 ——这会让 JDWP 只监听本地回环地址，远程 IDE 根本连不进来。
正确做法是只写端口号（如 5005）或显式绑定到 0.0.0.0:5005：
- Java 8u191+ 默认只允许
address=5005这种简写，它等价于0.0.0.0:5005；但老版本（如 Java 7 或早期 Java 8）可能仍需写0.0.0.0:5005 - 如果服务器有防火墙（比如 CentOS 的
firewalld），记得放行该端口：firewall-cmd --add-port=5005/tcp --permanent - 云服务器（如阿里云、AWS）还需检查安全组规则，开放对应端口入方向流量
启动命令必须用 catalina.sh jpda start 吗？
不用。只要你在 CATALINA_OPTS 里写了 JDWP 参数，就**完全不需要**用 jpda start 这个命令。直接 ./catalina.sh start 即可生效。
反过来，如果你用了 jpda start 却没配 JPDA_OPTS 或 JPDA_ADDRESS，Tomcat 会 fallback 到默认的 8000 端口，而这个端口很可能被占用或未放行。
- 推荐方式：在
bin/setenv.sh（Linux/macOS）或bin/setenv.bat（Windows）中设置CATALINA_OPTS，文件不存在就新建 - Windows 下
setenv.bat写法：set CATALINA_OPTS=-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 - Linux/macOS 下
setenv.sh写法：export CATALINA_OPTS="-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005" - 改完后执行
./catalina.sh start，看日志里是否出现Listening for transport dt_socket at address: 5005
suspend=n 是不是总得设成 n？
绝大多数情况必须设 suspend=n。设成 suspend=y 表示 JVM 启动后立刻挂起，等待调试器连接——但 Tomcat 启动过程本身有耗时操作（比如扫描 classpath、初始化 Servlet），如果 IDE 没及时连上，它可能卡死甚至超时失败。
只有两种场景适合 suspend=y：
- 你确定 IDE 能在几秒内完成连接（比如本地 VM 调试）
- 你想在应用初始化第一行代码就打断点（例如
ServletContextListener.contextInitialized()）
生产环境或远程服务器上，一律用 suspend=n。多一个 n 字，少半小时排查。
