CodeBuddy的doctor命令可自动诊断微服务故障，支持链路检测、Nacos实例核查、Feign路径比对、日志分析及一键修复。需CLI v2.8.0+，通过codebuddy doctor --help验证，支持--target、--nacos、--feign-interface、--log等参数精准定位问题并生成编号修复方案。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在微服务架构中遇到接口返回500、超时、空响应或跨服务链路断裂等复杂故障，且日志模糊、堆栈不全、上下游依赖状态不明时，CodeBuddy的doctor命令能自动执行多维度诊断，无需手动拼接curl、telnet、jstack或nacos查询命令。
确认doctor命令可用性与权限
打开终端，进入项目根目录，执行codebuddy doctor --help。若提示“command not found”，说明当前安装的CodeBuddy CLI版本低于v2.8.0——【doctor命令仅在2.8.0+版本中内置】，需先升级：npm install -g @tencent/codebuddy-cli@latest 或通过VS Code插件市场更新CodeBuddy插件至最新版。
执行codebuddy doctor --version确认输出为v2.8.0或更高。
触发基础链路诊断
在终端中直接运行：codebuddy doctor --target http://localhost:8080/api/v1/schedule/plan。该命令会自动检测目标URL是否可连通、响应头是否含CORS或Content-Type异常、HTTP状态码是否被网关拦截，并尝试解析Feign客户端配置文件（如application.yml）中的超时设置和重试策略。
若目标服务部署在K8s集群中，可替换为服务名：codebuddy doctor --target navigation-facility-service:8080/getBeaconDetail，此时命令会自动调用kubectl get endpoints验证服务端点就绪状态。
深度排查跨服务调用失败
当Feign调用报404或503，且已知下游服务（如navigation-facility-service）注册在Nacos中，执行以下三步：
- 第一步：获取当前服务在Nacos中的实例列表
运行codebuddy doctor --nacos --service navigation-facility-service，它会自动读取bootstrap.yml中的Nacos地址，拉取该服务所有健康实例IP+端口，并标记出未通过心跳检测的节点。 - 第二步：验证目标实例连通性与端口开放
从上一步输出中选取一个IP（如10.244.1.15:8080），执行codebuddy doctor --ping 10.244.1.15:8080 --http-path /actuator/health。这一步绕过服务发现层，直连实例探测真实存活状态；若返回Connection refused，说明Pod内应用进程已崩溃或端口未监听。 - 第三步：比对Feign接口定义与实际REST路径
运行codebuddy doctor --feign-interface com.example.client.NavigationFacilityFeignClient，它会扫描项目源码，提取该接口中@GetMapping("/beacons/{id}")等注解，并与Nacos中该服务实际暴露的OpenAPI路径做差异比对——若发现Feign路径为/beacons/{id}但Nacos注册路径为/api/v1/beacons/{id}，则立刻定位为路径前缀缺失问题。
结合日志上下文精准定位
方法一：粘贴完整错误堆栈
将IDE控制台中抛出的FeignException完整堆栈（含Caused by嵌套异常）复制，执行：codebuddy doctor --log，然后直接粘贴日志内容并回车。CodeBuddy会提取关键线索：如Read timed out触发超时分析模块，No instances available触发Nacos实例健康度检查，SSLHandshakeException则自动检测JVM信任库配置。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
方法二：指定日志文件路径
若日志已落盘，运行：codebuddy doctor --log ./logs/service-startup.log --context-lines 5。注意--context-lines参数必须显式指定，否则默认只读首尾10行，可能漏掉中间的关键异常链。
这一步操作起来很简单，直接把文件拖进去就行。
生成可执行修复方案
完成上述任一诊断后，CodeBuddy会在终端底部生成带编号的修复建议列表，例如：
① 【修改application.yml】将feign.client.config.default.connectTimeout: 2000提升至5000；
② 【执行命令】curl -X POST http://nacos-server:8848/nacos/v1/ns/instance?serviceName=navigation-facility-service&ip=10.244.1.15&port=8080&ephemeral=false强制下线异常实例；
③ 【代码补丁】在NavigationFacilityFeignClient.java第23行接口方法上添加@RequestLine("GET /api/v1/beacons/{id}")覆盖路径前缀。
选择某条建议编号（如输入2），按回车即可自动执行对应修复动作——网络命令实时运行，代码补丁直接写入文件，无需手动复制粘贴。
