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 Visio — Visio 兼容架构图生成器
下载
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
- 主机地址：优先填内网地址；若用外网，确保安全组/防火墙放通数据库端口（如 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 的用户数”，观察是否返回数字结果，而非报错或空响应
能稳定返回结构化数据，才算真正修好了。
