还在为线上环境“明明本地跑得好好的，一部署就崩”而抓狂？

想看看远程服务器上 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 容器，但行为略有不同：

📌 这不是 Bug！而是为了**不使用 Agent**做出的设计权衡。

解决方案很简单：连上后，先发一个 `curl http://your-app/health` 即可触发上下文加载。