如何在JetBrains Fleet中连接5005端口调试无主函数Quarkus应用

1. 确保Quarkus Dev模式开启调试端口 #

无主函数的Quarkus应用（如纯REST服务）在Dev模式下默认不会自动开启调试端口，必须通过启动参数强制开启：

• 在终端执行启动命令时添加调试参数：

  mvn quarkus:dev -Dquarkus.debug.enabled=true
  

• 启动后检查控制台输出，确认出现类似 Listening for transport dt_socket at address: 5005 的日志，说明调试端口已正常监听。
• 若需要修改默认端口（5005），可在application.properties中添加配置：

  quarkus.debug.port=你的自定义端口
  

2. 在Fleet中配置远程调试会话 #

• 打开Fleet的Run/Debug面板（快捷键：Ctrl+Shift+D）
• 点击面板中的Add Configuration，选择Remote JVM Debug类型
• 填写配置信息：
  • Name：自定义名称（如Quarkus Dev Debug）
  • Host：localhost（本地调试无需修改）
  • Port：填写Quarkus配置的调试端口（默认5005）
  • Transport：选择Socket
  • Mode：选择Attach

3. 启动调试并验证 #

• 确保Quarkus Dev模式进程处于运行状态（已输出调试端口监听日志）
• 在Fleet的Run/Debug面板中选中刚才创建的调试配置，点击Debug按钮（绿色调试图标）
• 在代码中设置断点（点击代码行号左侧区域），发送请求触发业务逻辑，断点会自动命中，此时可进行变量查看、单步调试等操作

常见问题排查 #

• 若调试连接失败，先确认Quarkus启动命令是否加了-Dquarkus.debug.enabled=true参数，且进程未被终止
• 检查Fleet使用的JDK版本与Quarkus应用依赖的JDK版本是否一致，版本不匹配可能导致调试异常
• 若自定义了调试端口，确保Fleet配置中的端口与Quarkus配置完全一致

内容的提问来源于stack exchange，提问作者Theodosis