常见报错原因包括mysql服务未运行、sql模式过严或字符集不兼容；需依次验证服务连接、调整sql模式为no_engine_substitution、设utf8mb4字符集、检查脚本语法兼容性，并启用通用日志定位失败语句。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在执行 WorkBuddy 数据库初始化脚本时遇到报错，常见原因包括 MySQL 服务未运行、SQL 模式（SQL Mode）限制过严或字符集（Character Set）不兼容，导致 CREATE TABLE 或 INSERT 语句被拒绝。以下是针对性排查与修复步骤：
一、验证 MySQL 服务状态与连接可用性
初始化脚本执行前必须确保数据库服务已就绪且客户端可访问，否则将直接中断并抛出连接异常。该步骤排除网络、认证及服务离线等前置障碍。
1、在终端中运行 mysql --version 确认客户端已安装且版本不低于 8.0.23。
2、执行 mysql -u root -p -e "SELECT 1;" 测试本地连接；若提示 Access denied 或 Can't connect，需先修复用户权限或检查 mysqld 是否运行。
3、若使用 Docker 部署，运行 docker ps | grep mysql 查看容器状态，再执行 docker exec -it
二、检查当前 SQL 模式是否启用严格模式
WorkBuddy 初始化脚本依赖标准 SQL 语法，而 MySQL 默认启用的 STRICT_TRANS_TABLES 或 ONLY_FULL_GROUP_BY 等严格模式会拒绝无默认值的 NOT NULL 字段定义或隐式类型转换，导致建表失败。
1、登录 MySQL 后执行 SELECT @@sql_mode; 查看当前全局与会话级 SQL 模式。
2、重点识别是否存在 STRICT_TRANS_TABLES、STRICT_ALL_TABLES、NO_ZERO_DATE、NO_ZERO_IN_DATE 等关键词。
3、临时禁用严格模式：执行 SET SESSION sql_mode = 'NO_ENGINE_SUBSTITUTION';（仅对当前会话生效）。
4、若需永久修改，编辑 MySQL 配置文件（如 /etc/mysql/my.cnf 或 /usr/local/etc/my.cnf），在 [mysqld] 段落下添加 sql_mode = NO_ENGINE_SUBSTITUTION，并重启 mysqld 服务。
三、确认数据库默认字符集与排序规则兼容 UTF8MB4
WorkBuddy 要求完整支持四字节 Unicode 字符（如 emoji、部分生僻汉字），若数据库或表级字符集仍为 utf8（实际为 utf8mb3），将触发 ERROR 1071: Specified key was too long 错误，尤其在含长文本索引的字段上。
1、执行 SHOW VARIABLES LIKE 'character_set%'; 与 SHOW VARIABLES LIKE 'collation%'; 查看服务级默认设置。
2、确认 character_set_server 和 collation_server 值分别为 utf8mb4 与 utf8mb4_0900_ai_ci；若非此值，需修改配置。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
3、在 my.cnf 的 [mysqld] 段落追加以下两行：
character-set-server = utf8mb4
collation-server = utf8mb4_0900_ai_ci
4、重启 MySQL 后，创建数据库时显式指定：CREATE DATABASE workbuddy DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;
四、手动预检初始化脚本中的高危语法结构
部分版本的初始化 SQL 脚本可能包含 MySQL 8.0+ 不兼容的旧语法（如 USING BTREE 在 FULLTEXT 索引中），或未适配严格模式的字段定义（如 DATETIME NOT NULL 无 DEFAULT）。该方式可绕过黑盒执行，提前暴露语法冲突点。
1、使用文本编辑器打开 init.sql，搜索关键字 NOT NULL、DEFAULT、FULLTEXT、USING、AUTO_INCREMENT。
2、检查所有 NOT NULL 字段是否均配有 DEFAULT 值或明确声明 AUTO_INCREMENT；若无，需补充 DEFAULT CURRENT_TIMESTAMP 或 DEFAULT ''。
3、定位含 USING BTREE 的 FULLTEXT 索引语句，将其替换为：FULLTEXT (column_name) WITH PARSER ngram（适用于中文分词）或直接移除 USING 子句。
4、对含 JSON 类型字段的建表语句，确认 MySQL 版本 ≥ 5.7.8；否则需改用 LONGTEXT 并在应用层解析。
五、启用 MySQL 通用查询日志捕获失败语句上下文
当错误信息仅显示“Query failed”而无具体 SQL 行号时，开启通用日志可记录脚本执行全过程，精确定位哪条语句触发中断，避免盲目猜测。
1、登录 MySQL，执行 SET GLOBAL general_log = ON; SET GLOBAL log_output = 'TABLE';
2、重新运行初始化脚本（如 mysql -u root -p workbuddy
3、执行 SELECT * FROM mysql.general_log ORDER BY event_time DESC LIMIT 50; 提取最后 50 条日志。
4、查找 log_event_type = 'Query' 且 argument 字段以 CREATE TABLE 或 INSERT 开头的记录，重点关注其后紧跟的 Error 类型日志行。
