在Spring Cloud微服务架构中，排查Feign调用返回404错误时，首要步骤是确认CodeBuddy能否正确识别服务间的依赖关系。它并非依赖猜测，而是基于Maven多模块结构中的parent/pom.xml以及子模块之间的
让CodeBuddy识别微服务模块拓扑
打开VS Code，确保工作区根目录下包含完整的Maven工程结构——即顶层pom.xml必须存在，各子模块也需正确声明。需要特别注意的是，CodeBuddy仅在检测到有效的parent-pom.xml时，才会启动微服务分析引擎。
点击左侧活动栏的CodeBuddy图标，进入“架构洞察”面板。随后等待右下角状态栏弹出提示：“✅ 已加载3个服务模块：ship-schedule-service、navigation-facility-service、common-util”。如果迟迟未出现该提示，说明父POM未被识别，或者子模块中缺少
验证服务间调用链是否被正确建模
方法一：在ship-schedule-service模块的Feign接口文件中，将光标悬停在@FeignClient("navigation-facility-service")注解上。CodeBuddy会立即弹出一张服务详情卡片，清晰展示目标服务的包路径、暴露的端点列表以及DTO类的引用关系。如果卡片为空，或提示“未找到对应服务”，则说明navigation-facility-service未被纳入分析范围——这是排查问题的第一步。
方法二：切换到navigation-facility-service模块的Controller类，在@GetMapping("/beacon/{id}")方法签名处右键，选择“CodeBuddy: 查看被哪些服务调用”。此时，面板将列出所有已识别的调用方，包括ship-schedule-service中具体是哪个Feign接口、哪一行代码发起了调用。这一步能够直接验证服务注册与调用路径是否双向打通，比手动翻查代码高效得多。
手动触发跨模块符号索引
第一步：在终端中执行mvn clean compile，确保所有模块编译通过且class文件成功生成。这一步看似基础，却是整个流程的关键基石。
第二步：返回CodeBuddy面板，点击右上角的刷新按钮（↻），选择“强制重建服务图谱”。
第三步：观察日志输出——当看到“Indexed 127 classes across 3 modules, resolved 8 inter-service DTO references”这行信息时，即表示跨模块类型引用已经就绪。
这一步不可跳过。如果仅依赖IDE缓存，CodeBuddy很可能无法解析navigation-facility-service中定义的BeaconDetailDTO在ship-schedule-service中的实际使用位置。一旦缺少这层上下文，后续的AI分析就会如同盲人摸象，缺失最关键的信息拼图。
