断点无效的根本原因是IDEA未正确识别Spring Boot模块上下文，需依次执行三步：确认各模块被标记为【Spring Boot】并含spring-boot-starter-web依赖；为每个微服务单独配置Debug启动项且绑定对应模块；关闭自动编译、强制重刷Maven依赖并检查模块间依赖scope是否为compile。
你在调试一个包含用户服务、订单服务和网关模块的 Spring Boot 多模块项目时，发现断点根本进不去，或者只在某个模块生效，其他模块变量全显示为 null——这不是代码问题，而是 IDEA 的调试上下文没对齐。
确认模块是否被正确识别为 Spring Boot 模块
打开项目结构（File → Project Structure → Modules），检查每个子模块是否带有 【Spring Boot】 图标。如果没有，右键模块 → Add Framework Support → 选择 Spring Boot。这一步漏掉会导致 IDEA 不加载 Spring Boot 的调试增强能力，断点将无法解析 @RestController 或 @Service 中的方法。
检查每个模块的 pom.xml 是否含有 spring-boot-starter-web 依赖。若只有 spring-boot-starter（无 web），则该模块不会启动内嵌 Tomcat，也就无法触发 Web 层断点——哪怕你加了断点，IDEA 也会静默跳过。
点击任意模块的主类（含 @SpringBootApplication 注解的类），看右上角运行配置下拉框中是否显示 “Spring Boot” 类型。如果显示的是 “Application”，说明 IDEA 没识别出 Spring Boot 上下文，此时断点行为不可靠。
为不同微服务配置独立的 Debug 启动项
方法一：基于已有配置快速复制
点击右上角运行配置下拉框旁的 ▼ → Edit Configurations… → 左侧选中当前可用的 Spring Boot 配置 → 点击左上角 “+” → Duplicate。新配置自动继承主类、模块、工作目录等关键项。
方法二：手动新建并精准绑定模块
在 Edit Configurations… 界面点击 “+” → Spring Boot → 填写 Name（如 user-service-debug）→ 在 Main class 中点击 … 按钮，从当前项目中仅选择 user-service 模块下的 Application 类 → 关键：在 Module 下拉框中必须手动选择 user-service 模块，不能留空或选父工程。
方法三：用 Maven 命令行方式启动调试（适用于 CI/CD 调试复现）
在 Terminal 中进入 user-service 目录 → 执行：mvn spring-boot:run -Dspring-boot.run.jvmArguments="-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5006" → 回到 IDEA → Run → Attach to Process… → 选择 localhost:5006。这种方式绕过 IDEA 自动构建流程，适合验证是否为构建缓存导致的断点失效。
解决多模块间断点不触发的三大关键操作
第一步：关闭“Auto-reload on changes”干扰
Settings → Build, Execution, Deployment → Compiler → 取消勾选 “Build project automatically”。IDEA 在自动编译时可能跳过某些模块的字节码重生成，导致你修改后断点仍指向旧 class 文件。
第二步：强制刷新所有模块的依赖与输出
点击右侧 Maven 工具窗口 → 点击最顶部的刷新图标（Reimport project）→ 等待进度条结束 → 再执行 Build → Build Modules → 全选所有模块 → OK。这一步确保每个模块的 target/classes 与源码完全同步，避免因 classpath 混乱导致断点挂载失败。
第三步：检查模块间依赖是否为 compile 范围
打开 order-service 的 pom.xml → 查找对 user-service 的 dependency → 确认没有写
远程调试微服务实例：本地连测试环境的库存服务
在测试服务器上启动库存服务时，必须添加 JVM 调试参数：-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005。注意 address=*:5005 表示监听所有网卡，而非 localhost:5005，否则本地 IDEA 无法连接。
在 IDEA 中配置 Remote JVM Debug：Run → Edit Configurations… → “+” → Remote JVM Debug → 设置 Host 为测试服务器 IP（如 192.168.10.22），Port 为 5005 → 点击 OK。
启动该 Remote 配置前，务必确认防火墙已放行 5005 端口，且服务器 SELinux 或 iptables 未拦截入向连接。否则 IDEA 会提示 “Connection refused”，而不是超时。
在本地代码中设置断点，访问测试环境的接口（如 curl http://192.168.10.22:8080/inventory/check），触发远程服务执行，断点即被命中。
