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,比如:

bash 复制代码
-javaagent:/path/to/some-debug-agent.jar

但问题来了:

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

IntelliJ IDEA 的方案完全不同 :

✅ 不依赖任何 agent

✅ 不侵入业务代码

✅ 只需标准 JVM 远程调试端口

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


🛠️ 如何配置远程调试?三步搞定!

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

以 Docker Compose 为例:

yaml 复制代码
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,直接加到启动命令里:

bash 复制代码
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 即可触发上下文加载。


相关推荐
ZhengEnCi5 分钟前
AI 总模仿代码库里的过时写法怎么办:先清坏样例,再用类型与测试让 AI 无法犯错
人工智能·ai编程
码事漫谈11 分钟前
以后人人都可以成为导演
后端
Resean022317 分钟前
Spring 源码分析(二)配置类的解析与扫描
java·后端·spring
一只爱撸猫的程序猿18 分钟前
五周、两个开源仓库、九次拦截之后:AI 时代程序员缺的到底是什么
人工智能·后端·开源
GitCode官方1 小时前
开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用
人工智能·华为·harmonyos·atomgit
老金带你玩AI1 小时前
GPT-6.2更强更便宜了,为什么还有人骂?
人工智能
CyrusYiVPP2 小时前
实测 uv 0.13.7:同一套包,pip 装 94 秒,它只用 19 秒
人工智能·python
泯泷2 小时前
OpenClaw 退潮背后,是 AI 圈“技术自嗨”的终结
人工智能·chatgpt·llm
罗西的思考2 小时前
【轻量化复刻大模型 / KIMI K3】Muon 优化器及 训练系统
人工智能·算法·机器学习
北城笑笑2 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue