Spring Boot 远程调试终于来了！IntelliJ IDEA 新版支持「无 Agent」远程调试

还在为线上环境“明明本地跑得好好的，一部署就崩”而抓狂？
想看看远程服务器上 Spring 的 Bean 到底长啥样，却只能靠 log.info() 猜谜？

好消息来了！IntelliJ IDEA 的 Spring Debugger 插件在 2026 年初正式支持远程调试，而且——完全不需要 debug agent！

今天我们就手把手教你如何用这个“魔法功能”，把远程 Spring Boot 应用变成你的“透明玻璃盒”。

---

🔍 什么是 Spring Debugger？

先快速回顾一下：
Spring Debugger 是 JetBrains 在 2025 年 5 月推出的官方插件，专治 Spring Boot 的“黑盒病”。

它能让你在 Debug 时：

• 实时查看所有已注册的 Bean
• 检查 配置属性（如 application.yml 中的值）
• 分析 事务边界
• 执行 表达式求值（比如 userService.findById(1).getName()）

但之前它只支持 本地应用。现在，它终于能连上 远程服务 了！

---

🌐 为什么“无 Agent”这么重要？

很多远程调试方案要求你在启动时加 -javaagent，比如：

-javaagent:/path/to/some-debug-agent.jar

但问题来了：

• 需要修改部署脚本
• 可能影响性能
• 生产环境通常禁止加载未知 agent

IntelliJ IDEA 的方案完全不同：
✅ 不依赖任何 agent
✅ 不侵入业务代码
✅ 只需标准 JVM 远程调试端口

这就像你去朋友家串门——不用换鞋、不用登记，直接推门进去聊天 😎

---

🛠️ 如何配置远程调试？三步搞定！

第一步：启动远程应用时开启 JDWP 调试端口

以 Docker Compose 为例：

http-server:
  image: 'your-spring-app:latest'
  environment:
    - JAVA_TOOL_OPTIONS=-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005
  ports:
    - '8080:8080'   # 应用端口
    - '5005:5005'   # 调试端口

关键参数解释：

• address=*:5005：监听所有 IP 的 5005 端口（生产环境建议限制 IP）
• suspend=n：应用启动时不等待调试器（避免卡住）

💡 小贴士：如果你用的是 java -jar，直接加到启动命令里：

java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 -jar app.jar

---

第二步：在 IntelliJ IDEA 中创建「Remote JVM Debug」配置

1. 点击右上角下拉 → Edit Configurations
2. 点击 + → 选择 Remote JVM Debug
3. 填写：
   • Host: 你的服务器 IP（如 192.168.1.100 或 your-domain.com）
   • Port: 5005
   • Module classpath: 选择你的 Spring Boot 模块（确保源码匹配）

✅ 这一步是关键！如果 classpath 不对，断点会失效或无法查看变量。

---

第三步：点击 Debug，开始“透视”远程应用！

连接成功后，你就能：

• 在任意方法打 断点
• 查看 调用栈 和 局部变量
• 在 Spring Debugger 面板 中浏览所有 Bean
• 实时执行 SpEL 表达式（如 @myService.doSomething()）

就像在本地开发一样丝滑！

---

⚙️ 支持哪些内嵌容器？有坑吗？

目前支持三大主流内嵌 Servlet 容器，但行为略有不同：

容器	上下文加载时机	说明
Tomcat	立即可用	启动后立刻能查看 Bean
Jetty / Undertow	需首次请求后	因线程模型差异，需等第一个 HTTP 请求到达

📌 这不是 Bug！而是为了不使用 Agent做出的设计权衡。
解决方案很简单：连上后，先发一个 curl http://your-app/health 即可触发上下文加载。

---