IntelliJ IDEA远程调试需三步打通链路：服务端启用JDWP参数（如-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005），网络放行端口并配置防火墙/安全组，IDEA中创建Remote JVM Debug配置并严格匹配Host与Port；调试前须确保本地源码与远程class一致，JDK版本兼容，且生产环境必须通过SSH隧道或IP白名单加固安全。
在 IntelliJ IDEA 中对 Java 应用进行调试，既要能快速定位本地代码逻辑问题，又要能安全、准确地连接远程服务器上的 JVM 实例排查生产环境异常。你必须确保本地源码与远程 class 文件完全一致，否则断点会失效；端口被占用、防火墙拦截、JDK 版本差异都会导致连接失败。
本地 Debug：启动即进断点
第一步：在目标方法左侧行号区单击，或将光标停在某行按 Ctrl + F8（Windows/Linux）或 Cmd + F8（macOS）打上断点。
第二步：右键类中 main 方法 → 选择 “Debug ‘ClassName.main()’”，IDEA 自动编译并以调试模式启动 JVM。
第三步：程序运行至断点处自动暂停，Debug 工具栏弹出，变量区实时显示当前作用域所有变量值。注意：若断点未触发，检查是否误打了“方法断点”（灰色小圆点），应使用实心红点的行断点。
远程 JVM 调试：三步打通连接链路
远程调试本质是本地 IDEA 作为客户端，连接远程 JVM 启动时暴露的调试服务端口。整个链路依赖三个环节严丝合缝：远程 JVM 必须带调试 agent 启动、网络通路必须放行端口、IDEA 配置必须与服务端参数严格匹配。
方法一：服务端启动时注入 JDWP 参数
在远程服务器上执行启动命令时，必须添加 -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005。JDK 9+ 必须用 address=*:5005，JDK 8 及以下只能用 address=5005；suspend=n 表示应用立即运行，不等待调试器；若设为 suspend=y，进程会卡住，直到 IDEA 连上才继续——这在无人值守的服务器上极易造成超时失败。
方法二：Tomcat / Jetty 等容器配置调试参数
编辑 catalina.sh（Tomcat）或 jetty.sh（Jetty），在文件顶部追加一行：JAVA_OPTS="-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005"。重启容器后，所有部署在其上的 Web 应用都自动启用调试能力。
方法三：Docker 容器内启用调试
构建镜像时，在 Dockerfile 的 ENTRYPOINT 或 CMD 命令前插入 JVM 参数；若已运行容器，可用 docker exec -it [container] sh 进入后手动 kill 并重起 Java 进程，但需确保容器内安装了 JDK 且端口映射正确（如 -p 5005:5005）。
IDEA 端配置 Remote JVM Debug
第一步：打开 Run → Edit Configurations → 点击左上角 + → 选择 Remote JVM Debug。
第二步：填写 Host 和 Port —— Host 必须填远程服务器可解析的 IP 或域名，不能填 localhost 或 127.0.0.1；Port 必须与服务端 address 参数中的端口号完全一致。
使用3×3×10框架生成90+个个性化Instagram内容创意，用AI编辑器精选最佳创意，并将获胜者扩展为可操作的简洁内容。
第三步：确认 Debugger mode 为 Attach to remote JVM，Transport 为 Socket；下方 Module classpath 若为空，点击 Fix 指向你本地项目的 module，否则无法解析源码行号。
第四步：勾选 “Allow unsigned requests”，避免因自签名证书或 HTTP 代理拦截导致连接中断；此项仅在内网可信环境启用，生产环境禁用。
第五步：点击 OK 保存配置，回到主界面，点击右上角调试按钮（? 图标）或按 Shift + F9 启动连接。IDEA 底部状态栏显示 “Connected to the target VM” 即表示链路打通。
断点命中失败？先查这四件事
① 检查远程 JVM 进程是否真在监听目标端口：在服务器执行 netstat -tuln | grep :5005，有 LISTEN 才算成功暴露。
② 查看 IDEA 控制台输出的错误信息：若提示 “Connection refused”，说明网络不通或服务端根本没启动调试；若提示 “Unable to open debugger port”，大概率是端口被占用或防火墙拦截。
③ 核对本地源码与远程 class 是否同版本：编译时间戳、git commit hash、jar 包 SHA256 值三者任一不一致，断点就无法映射到正确字节码位置。
④ 确认远程 JVM 使用的 JDK 版本：JDK 17+ 默认禁用 jdwp agent，需额外添加 --add-opens java.base/jdk.internal.agent=ALL-UNNAMED 参数，否则连接直接拒绝。
调试中修改变量值并生效
在 Debug 模式下暂停时，展开 Variables 面板，找到目标变量，双击其 Value 列，输入新值后按 Enter。
基本类型（int、boolean、String）可直接赋新值；对象引用可替换为 new 实例，但注意该实例必须已在当前类加载器中定义过，否则抛 NoClassDefFoundError。
【警告】对 static final 字段赋值会失败，JVM 层面禁止运行时修改常量池内容；对集合类调用 add/remove 方法可能引发 ConcurrentModificationException，需配合 suspend 当前线程再操作。
远程调试安全加固要点
生产环境严禁开放公网调试端口。必须限制访问来源：在服务器防火墙中只允许开发机 IP 访问调试端口，例如 firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="192.168.10.22" port port="5005" protocol="tcp" accept'。
云服务器还需同步配置安全组规则，放行对应端口和源 IP；调试完成后立即关闭端口或停止 JVM，切勿长期保持 suspend=n 状态。
若必须跨公网调试，强制使用 SSH 端口转发：本地执行 ssh -L 5005:localhost:5005 user@prod-server-ip，IDEA 中 Host 改为 localhost，Port 仍为 5005 —— 所有调试流量经加密隧道传输，规避中间人劫持风险。
