workbuddy 的数据库连接问题本质是数据层通路故障，需验证“数据连接”状态、手动测试连通性、检查mcp server运行及四关键配置（主机、端口库名、只读账号、mcp服务），再通过自然语言查表与查询验证真实可用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 本身不内置数据库能力，所谓“代码模型修复数据库连接”，其实是误把模型层和数据层混为一谈。真正要修的不是模型，而是 WorkBuddy 到数据库之间的那条“数据连接”。只要这条通路连通、权限正确、协议兼容，自然语言查库、生成 SQL、执行巡检就都能跑起来。
确认数据库连接是否真的断了
别急着重配，先快速验证问题出在哪一层：
- 在 WorkBuddy 的「数据连接」设置页里，看对应数据库条目状态是否显示“未连接”或“测试失败”
- 用命令行手动连一次：比如 psql -h your-host -U your-user -d your-db（PostgreSQL）或 mysql -h your-host -P 3306 -u your-user -p（MySQL），确认网络、账号、端口都通
- 检查 WorkBuddy 日志（设置 → 开发者选项 → 查看日志），搜索关键词如 “connection refused”、“access denied”、“timeout”
重配数据库连接的四个关键项
WorkBuddy 接数据库靠的是 MCP 协议桥接服务（比如 postgresql-mcp-server），配置时必须填准以下四项，缺一不可：
workbuddy-pet
下载
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
- 主机地址：优先填内网地址；若用外网，确保安全组/防火墙放通数据库端口（如 5432 / 3306）
- 端口与数据库名：不能写错，默认端口≠实际端口；库名要和 CREATE DATABASE 时完全一致，区分大小写
- 专用只读账号：不要用 root/admin，新建一个普通账号，并显式授予 CONNECT 和 SELECT ON ALL TABLES IN SCHEMA 权限
- MCP Server 运行状态：它才是真正在和数据库对话的中间件。确认它已启动（如 npx @mcp/postgresql-mcp-server），且日志中出现 “listening on http://localhost:3000”
常见报错及对应解法
遇到这些提示，不用重装，照着改就行：
- “Failed to connect to database: Connection refused” → 数据库服务没启，或地址/端口填错，或网络隔离（比如云数据库没绑定到 WorkBuddy 所在 VPC）
- “Access denied for user 'xxx'@'%'” → 账号密码错误，或该账号没被授权从 WorkBuddy 所在 IP 登录（MySQL 需 GRANT ... ON *.* TO 'xxx'@'workbuddy-ip'）
- “Schema not loaded” 或 “No tables found” → MCP Server 成功连上库，但没读到元数据；检查账号是否有 pg_catalog 或 information_schema 查询权限
- “SQL execution timeout” → 查询太重，或数据库负载高；进 MCP Server 配置加 --timeout 30000 参数，或限制自然语言提问范围（如加上“只查最近7天数据”）
验证连接是否真正生效
配置保存后，别只信界面上的“已连接”绿标——做两件事确认真实可用：
- 在会话窗口输入：“列出当前数据库里的所有表”，看是否返回真实表名列表
- 再试一句：“查 users 表里 status=active 的用户数”，观察是否返回数字结果，而非报错或空响应
能稳定返回结构化数据，才算真正修好了。
