Spring Boot 3 移除了在 Maven 进程中直接运行应用并调试的能力，必须改用 spring-boot.run.jvmArguments 配置 JVM 调试参数，通过远程调试端口连接 IDE，这是升级到 Spring Boot 3 后必须调整的关键调试实践。
spring boot 3 移除了在 maven 进程中直接运行应用并调试的能力，必须改用 `spring-boot.run.jvmarguments` 配置 jvm 调试参数，通过远程调试端口连接 ide，这是升级到 spring boot 3 后必须调整的关键调试实践。
Spring Boot 3 对开发体验进行了结构性优化，其中一项重要变更便是彻底移除了「在 Maven 进程内启动应用」的模式（即 fork=false 的传统调试方式）。该能力早在 Spring Boot 2.7 中已被标记为 deprecated，并在 3.0 正式版中完全移除。这意味着你无法再通过 -Dspring-boot.run.fork=false 让 spring-boot:run 在当前 Maven JVM 中执行主类——因此断点（如 SpringApplication.run(...) 行）自然无法命中。
取而代之的是标准化的 远程 JVM 调试机制：Spring Boot Maven Plugin 会启动一个独立的子 JVM 来运行你的应用，并允许你通过 jvmArguments 注入标准的 JDWP（Java Debug Wire Protocol）参数，从而支持 IDE 连接调试。
✅ 正确的 Spring Boot 3 调试命令示例
mvn spring-boot:run \ -Dspring-boot.run.jvmArguments="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=*:5005"
? 参数说明：
- -Xdebug：启用调试支持（JDK 8 及以前必需；JDK 9+ 可省略，但保留更兼容）
- -Xrunjdwp：JDWP 协议配置
- transport=dt_socket：使用 socket 通信
- server=y：当前 JVM 作为调试服务器（等待 IDE 连接）
- suspend=y：启动时挂起，确保断点在初始化前生效（推荐，避免错过早期 Bean 创建）
- address=*:5005：监听所有网络接口的 5005 端口（Spring Boot 3.1+ 支持 address=5005 简写，默认绑定 localhost；若需远程调试或 Docker 场景，显式写 *:5005 更可靠）
? IDE 连接方式（以 IntelliJ IDEA 为例）
- 启动上述 Maven 命令，控制台将显示 Listening for transport dt_socket at address: 5005 并暂停；
- 在 IDEA 中点击 Run → Debug → Add Configuration… → Remote JVM Debug；
- 设置 Host=localhost，Port=5005，确认后点击 ▶️ Debug；
- 应用恢复执行，所有断点（含 main 方法、@PostConstruct、@EventListener 等早期钩子）均可正常触发。
⚠️ 注意事项与最佳实践
- 勿混用 fork=false：Spring Boot 3 下该参数已无效，强行指定将被忽略，且可能引发误导性行为；
- suspend=y 是关键：若设为 suspend=n，应用会立即启动，IDE 连接前的初始化逻辑（如 ApplicationContext 刷新）将无法调试；
- 端口冲突处理：若 5005 被占用，可更换端口（如 address=*:8000），并同步更新 IDE 配置；
- 生产环境禁用：jvmArguments 仅用于开发阶段，切勿提交至 CI/CD 或生产构建配置；
- Gradle 用户注意：对应方案为 bootRun.jvmArgs = ["-Xdebug", "-Xrunjdwp:..."]，语法不同但原理一致。
✅ 总结
Spring Boot 3 的调试并非“变难”，而是更贴近 Java 应用的标准调试范式——它强制解耦构建进程（Maven/Gradle）与运行时 JVM，提升了稳定性与可预测性。开发者只需一次适配：放弃 fork=false 思维，拥抱 jvmArguments + 远程调试 模式。这一变更不仅兼容所有主流 IDE（IntelliJ、Eclipse、VS Code + Extension），也为容器化调试（如 Kubernetes kubectl port-forward）和 CI 环境下的诊断提供了统一基础。升级时务必同步更新团队开发文档与脚本，避免因调试失效导致排查效率下降。
