Plan模式将微服务调试从试错循环变为一次对齐：通过结构化诊断树定位契约断裂点，生成含验证预期的执行清单，并自动同步HTTP契约快照与修正建议至文档。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在微服务调用中反复遇到404、500或超时错误，每次靠手动改Feign接口、查Nacos注册名、翻日志再重试，改三次才跑通——Plan模式能帮你把这类返修从“试错循环”变成“一次对齐”。
先让Plan模式接管调试起点
打开CodeBuddy IDE → 新建对话 → 选择Plan模式 → 在输入框粘贴完整报错栈（含Feign调用路径、HTTP状态码、服务名）。
这一步不能只写“接口404”，必须带上下文：比如feign.FeignException: status 404 reading NavigationFacilityFeignClient#getBeaconDetail(Long)，否则Plan会默认按单体应用推理，漏掉服务发现环节。
点击发送后，Plan不会立刻给修复代码，而是先输出结构化诊断树：依赖链→服务注册状态→接口契约一致性→网络可达性→参数序列化规则。
聚焦服务契约校验环节
Plan模式会自动生成三组比对项：
方法一：对比提供方Controller的@RequestMapping路径与消费方FeignClient的@FeignClient(name="navigation-facility-service") + @GetMapping("/api/beacon/{id}")是否完全匹配（含版本前缀、斜杠结尾）；
方法二：检查提供方接口返回类型是否为RestResponse
方法三：验证Nacos中navigation-facility-service实例的元数据标签是否含version: v2，而Feign客户端是否通过@RequestHeader("X-Service-Version")透传了该版本头。
【关键点】Plan会标出“契约断裂点”而非直接改代码——比如它指出“/api/beacon/{id}在提供方实际映射为/api/v2/beacon/{id}”，你只需调整Feign路径，不用动配置或重启服务。
生成可验证的调试执行清单
第一步：在Nacos控制台搜索navigation-facility-service → 确认健康实例数≥1且元数据version=v2；
第二步：用curl -v http://localhost:8080/api/v2/beacon/123 直接访问提供方本地端点 → 验证接口是否存在且返回200；
第三步：在船舶调度服务中开启Feign日志（logging.level.com.xxx.NavigationFacilityFeignClient=DEBUG）→ 观察实际发出的URL是否带v2前缀；
第四步：若前三步均通过但调用仍404，Plan会提示检查Spring Cloud LoadBalancer是否启用服务发现缓存（需加spring.cloud.loadbalancer.cache.enabled=false临时关闭）。
每条指令都附带验证预期结果，例如“curl返回200且body含beaconId字段”——避免你误判某步已通过。
同步更新文档与契约快照
Plan模式最后一步自动导出当前调试结论为Markdown文件，包含：
① 服务间HTTP契约快照（含路径、请求头、响应体结构）；
② Nacos注册元数据截图（自动调用API抓取）；
③ Feign客户端配置修正建议（精确到行号）；
④ 下次上线前必须校验的三项Checklist。
这份文件直接存入项目/docs/debug-plan-20260701.md，下次同类问题出现时，新成员双击打开就能复现验证路径，不用再问“上次怎么修的”。
