workbuddy 连接 mysql 异常通常由版本不兼容（需 ≥5.6）、非 innodb 引擎（如 myisam）或参数配置不当（如日志关闭、max_allowed_packet 过小）导致，可通过版本检查、引擎转换、参数校验、内置诊断命令及兼容模式临时解决。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试使用 WorkBuddy 连接或操作 MySQL 数据库，但连接失败、查询报错或功能异常，则很可能是由于 MySQL 版本不兼容、数据库引擎不匹配或参数组配置不当所致。以下是确认并解决此类问题的具体步骤：
一、验证 MySQL 服务端版本兼容性
WorkBuddy 本身不直接限制 MySQL 版本，但其底层依赖的连接驱动（如 MySQL Connector/J 或 mysqlclient）及所调用的 SQL 语法特性，对 MySQL 服务端版本存在隐式要求。低版本 MySQL（如 5.1）可能缺失 JSON 函数、窗口函数、CTE 等特性，导致 WorkBuddy 的日志分析、SQL 重写、自动优化等高级功能无法执行。
1、在 MySQL 命令行中执行 SELECT VERSION(); 获取当前服务端版本号。
2、比对官方支持矩阵：WorkBuddy 明确适配 MySQL 5.6 及以上版本；若返回结果为 5.1.x 或更低，请升级 MySQL 至 5.7.30+ 或 8.0.21+。
3、检查是否启用严格模式：执行 SELECT @@sql_mode;，确认结果中包含 STRICT_TRANS_TABLES 或 STRICT_ALL_TABLES；若无，建议在 my.cnf 中添加并重启服务。
二、确认存储引擎类型与表结构兼容性
WorkBuddy 在执行数据同步、结构分析、DDL 推荐等操作时，会读取 INFORMATION_SCHEMA 并解析表元数据。若存在非标准引擎（如 ARCHIVE、FEDERATED）或 MyISAM 表，可能导致元数据解析中断或字段类型误判，尤其影响“SQL 慢查询定位”与“自动索引建议”功能。
1、执行 SELECT ENGINE, COUNT(*) FROM information_schema.TABLES WHERE TABLE_SCHEMA NOT IN ('mysql','information_schema','performance_schema','sys') GROUP BY ENGINE; 查看当前数据库中各引擎分布。
2、重点检查是否存在 MyISAM 表：执行 SELECT TABLE_SCHEMA, TABLE_NAME FROM information_schema.TABLES WHERE ENGINE = 'MyISAM' AND TABLE_SCHEMA NOT IN ('mysql','information_schema','performance_schema','sys');
3、对查出的 MyISAM 表执行转换：使用 ALTER TABLE `db`.`table_name` ENGINE=InnoDB; 进行在线变更（MySQL 5.6+ 支持 ALGORITHM=INPLACE）。
三、校验参数组关键配置项
WorkBuddy 的 SQL 分析模块依赖服务器端开启 general_log 或 slow_query_log，并需确保日志格式、路径、权限等配置允许其安全读取。若参数组中禁用日志、设置 log_output='NONE' 或 max_allowed_packet 过小，将导致日志抓取失败、大 SQL 截断、JSON 解析错误等问题。
1、执行 SHOW VARIABLES LIKE 'general_log%'; 和 SHOW VARIABLES LIKE 'slow_query_log%'; 确认日志开关状态。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、检查日志输出方式：执行 SHOW VARIABLES LIKE 'log_output';，合法值应为 'FILE' 或 'TABLE'；若为 'NONE'，需修改参数组并重启实例。
3、验证最大包尺寸：执行 SHOW VARIABLES LIKE 'max_allowed_packet';，确保值 ≥ 64M（WorkBuddy 默认解析单条 SQL 最长支持 64MB 内容）。
四、测试 WorkBuddy 内置连接诊断命令
WorkBuddy 提供专用 CLI 工具 workbuddy-dbcheck，可脱离图形界面执行本地化兼容性检测。该命令自动验证连接连通性、版本语义支持度、必要系统表可读性及日志访问权限，输出结构化诊断报告。
1、打开终端，进入 WorkBuddy 安装目录下的 bin/ 子目录。
2、执行 ./workbuddy-dbcheck --host=127.0.0.1 --port=3306 --user=root --password=your_password --database=test（请替换为实际连接参数）。
3、观察输出中的 [PASS] 与 [FAIL] 条目，重点关注 version_compatibility、information_schema_access、slow_log_readable 三项状态。
五、绕过版本限制的临时适配方案
当无法立即升级 MySQL 或调整参数组时，可通过客户端侧降级策略维持基础功能可用。WorkBuddy 支持强制指定兼容模式运行，禁用依赖高版本特性的子模块，保留文件操作、文档生成、浏览器自动化等非数据库强依赖能力。
1、编辑 WorkBuddy 主配置文件 config.yaml，在 database: 节点下新增字段：compatibility_mode: "mysql-5.1"。
2、关闭所有正在运行的 WorkBuddy 实例，清空 workspace/.cache/db/ 目录缓存。
3、重启 WorkBuddy 并在控制台输入指令 /db status，确认提示信息中显示 "Running in compatibility mode for MySQL 5.1"。
