Spring Boot内嵌Tomcat时本地/远程调试断点失效如何解决？

核心原因 #

spring-boot:run命令默认会启动独立的子进程运行Spring Boot应用，你配置的MAVEN_OPTS仅作用于Maven主进程，调试参数没有传递到运行应用的子进程，因此Eclipse连接的实际是Maven主进程，才会出现仅显示单线程、断点无法命中的问题。

修复方案 #

方案一：禁用子进程fork模式（最简单） #

启动命令添加-Dspring-boot.run.fork=false参数，让应用直接运行在Maven主进程，之前配置的MAVEN_OPTS调试参数就会生效：

mvn spring-boot:run -Dspring-boot.run.fork=false

方案二：给Spring Boot插件单独配置调试参数 #

如果需要保留fork模式，直接将调试参数指定给Spring Boot Maven插件的子进程即可，有两种配置方式：

• 启动时动态传参：

mvn spring-boot:run -Dspring-boot.run.jvmArguments="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8000"

• 在pom.xml中固定配置插件参数：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <version>2.5.3</version>
    <configuration>
        <jvmArguments>
            -Xmx1024M -XX:MaxPermSize=256M -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8000
        </jvmArguments>
    </configuration>
</plugin>

配置完成后直接执行mvn spring-boot:run即可正常启用调试端口。

异常排查 #

如果配置完成后断点仍不生效，可依次检查以下项：

• 确认Eclipse本地代码和运行的代码版本完全一致，开启Project -> Build Automatically自动编译，避免修改后未编译导致断点位置不匹配
• 确认8000端口没有被其他进程占用，可执行netstat -ano | findstr 8000（Windows）或lsof -i:8000（Linux/macOS）验证端口所属进程为Spring Boot应用
• 如果你使用JDK 9及以上版本，需要将调试参数中的address=8000修改为address=*:8000，否则默认仅允许本地回环地址连接，可能出现连接异常
• 确认断点打在实际会被请求命中的代码块，不要在接口方法、抽象方法、完全被AOP代理的无效位置设置断点

内容的提问来源于stack exchange，提问作者Robyn.D