必须先建立数据库上下文感知能力，确认mysql mcp服务已启用，注入元数据并手动声明外键关系，再通过限定字段来源、显式join条件等方法发起查询，最后验证结果可靠性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在CodeBuddy中让AI准确执行跨表查询、自动补全JOIN语法、识别字段归属并避免笛卡尔积，必须先建立数据库上下文感知能力，不能只靠自然语言描述表名就指望AI猜对关联逻辑。
确认MySQL MCP服务已就绪
打开CodeBuddy设置 → MCP服务器 → 查看名为“mysql-server”的条目状态是否为 ENABLED。若显示 DISABLED 或不存在，说明底层MySQL MCP Server进程未启动或配置失效。
在终端执行 npx @anthropic/mcp-server-mysql --host 127.0.0.1 --port 3306 --user root --password 123456 --database spring_ai_copilot，观察是否有日志输出类似 Server listening on stdio。没有则说明Node.js环境缺失或包未正确安装。
【npx路径错误会导致MCP启动失败，务必用 where.exe npx 验证全路径】
向CodeBuddy注入数据库元数据
第一步：在CodeBuddy对话框中输入指令：“请读取当前MySQL MCP连接下的所有表结构”。
第二步：等待AI返回带字段名、类型、主键/外键标记的表格清单。若返回内容为空或仅提示“无法获取元数据”，说明MCP未成功暴露表信息，需退回上一步检查JSON配置中的env变量是否与命令行参数重复冲突。
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 问题
第三步：从中挑出两张有业务关联的表（例如 users 和 orders），手动补充一句：“orders.user_id 是外键，指向 users.id”。这步不能省略——AI不会自动推断外键关系，仅靠字段名相似性（如都含“id”）极易误连。
发起带JOIN的自然语言查询
方法一：直接提问
在Craft模式下输入：“查出所有用户姓名和他们最近一笔订单的金额，按订单时间倒序”。AI会生成含LEFT JOIN的SQL，并自动选择users.name和orders.amount字段，同时加上ORDER BY orders.created_at DESC LIMIT 1子句。
方法二：限定字段来源
输入：“从users表选name，从orders表选amount，用user_id关联，只取status='paid'的订单”。此时AI生成的SQL会显式写出ON users.id = orders.user_id，且WHERE条件紧贴JOIN之后，避免因条件位置错误导致索引失效。
方法三：规避隐式笛卡尔积
若提问时只说“查users和orders的所有组合”，AI可能生成无ON条件的交叉连接。必须追加约束：“要求每条结果必须满足users.id = orders.user_id，不允许空匹配”。
验证JOIN结果是否可信
将AI生成的SQL复制到MySQL客户端执行，对比返回行数与两表实际数据量。若users有100行、orders有500行，但查询结果只有80行，说明JOIN条件过滤过严——此时回到CodeBuddy追问：“为什么只返回80行？请检查orders表中user_id是否全部存在于users表中”，AI会调用SELECT COUNT(*) FROM orders WHERE user_id NOT IN (SELECT id FROM users)帮你定位脏数据。
若执行报错Unknown column 'xxx' in 'on clause'，证明AI拼错了字段别名或表别名。立即在提问中明确要求：“生成SQL时禁止使用表别名，所有字段必须带完整表名前缀”。
