Spring Boot 3 移除了在 Maven 进程内直接运行应用的能力，调试必须通过 spring-boot.run.jvmArguments 在独立 JVM 中启用远程调试，不再支持 fork=false 方式。
spring boot 3 移除了在 maven 进程内直接运行应用的能力，调试必须通过 `spring-boot.run.jvmarguments` 在独立 jvm 中启用远程调试，不再支持 `fork=false` 方式。
Spring Boot 3 对开发体验进行了重要重构，其中一项关键变化是彻底移除了 在 Maven 进程中直接启动应用（即非 fork 模式） 的能力。这一机制在 Spring Boot 2.7 中已被标记为 @Deprecated，并在 3.0 正式版中完全删除。这意味着你无法再通过 -Dspring-boot.run.fork=false 让 spring-boot:run 在当前 Maven JVM 中执行主类——因此，IDE 断点（如 SpringApplication.run(...) 行）将无法命中。
取而代之的是，Spring Boot 3 强制采用 fork 模式（默认开启），即插件会启动一个全新的 JVM 来运行你的应用。要在此模式下实现有效调试，必须显式配置 JVM 调试参数，使该子进程监听 JDWP（Java Debug Wire Protocol）端口，供 IDE 连接。
✅ 正确的 Spring Boot 3 调试命令
使用以下 Maven 命令启动并挂起等待调试器连接：
mvn spring-boot:run \ -Dspring-boot.run.jvmArguments="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=*:5005"
- suspend=y：使 JVM 启动后暂停，直到调试器连接成功，确保不跳过初始化断点；
- address=*:5005：监听所有网络接口的 5005 端口（生产环境请慎用 *，建议 localhost:5005）；
- transport=dt_socket：指定基于 socket 的调试传输协议，兼容所有主流 IDE（IntelliJ IDEA、Eclipse、VS Code + Extension）。
? 提示：若使用 IntelliJ IDEA，可直接点击右上角 Debug 'Spring Boot' 配置（自动识别 spring-boot:run），或通过 Run → Edit Configurations → Add New Configuration → Maven，在 Command line 中填入上述命令，并在 Runner → Environment → JVM Options 中追加调试参数（效果等同）。
⚠️ 注意事项与常见问题
- fork=false 已无效：Spring Boot 3 的 Maven 插件会忽略该参数，强制 fork；强行指定不会报错但无实际作用。
- 端口冲突：确保 5005（或其他自定义端口）未被占用，否则启动失败并抛出 Address already in use。
- 防火墙/WSL 限制：在 WSL2 或容器化开发环境中，若使用 address=*:5005，需确认 Windows 防火墙放行该端口，或改用 address=localhost:5005 并在 IDE 中连接 localhost:5005。
- Java 版本兼容性：Spring Boot 3 要求 JDK 17+，调试参数语法（如 -Xrunjdwp）在 JDK 17–21 中保持兼容；JDK 21+ 推荐使用更现代的 -agentlib:jdwp=... 形式（Spring Boot 3.2+ 已适配），但上述 -Xrunjdwp 在当前主流版本中仍完全可用。
? 总结
Spring Boot 3 的调试范式已从“共享 Maven JVM”转向“隔离子 JVM + 标准 JDWP 远程调试”。这不仅提升了稳定性（避免插件类加载器与应用类加载器冲突），也与云原生开发流程（如容器内调试、远程服务调试）更一致。开发者只需掌握一条核心命令和 IDE 的远程调试配置，即可无缝迁移。记住关键口诀：不设 fork=false，改用 jvmArguments，suspend=y 是调试可靠性的基石。
