workbuddy需连接mysql才能同步任务、读取权限或写入日志，必须确保mysql服务运行且网络可达，创建专用数据库与账号并授予最小必要权限，再通过application.yml、环境变量或.env配置连接参数，最后验证连接并初始化表结构。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy需要连接MySQL数据库才能同步任务数据、读取用户权限或写入操作日志，直接使用默认配置无法建立有效连接。
确认MySQL服务状态与网络可达性
打开终端或命令行工具，执行 mysql -h 127.0.0.1 -P 3306 -u root -p 测试本地MySQL是否运行。如果提示 Can't connect to MySQL server，说明MySQL未启动或端口被占用。
Linux/macOS下运行 sudo systemctl status mysql 查看服务状态；Windows请检查“服务”管理器中MySQL80是否为“正在运行”。【MySQL必须处于运行状态，且监听地址包含WorkBuddy所在主机的IP】
若WorkBuddy部署在Docker容器或远程服务器，需用 telnet your-mysql-host 3306 验证网络连通性——失败则需检查防火墙、安全组或MySQL绑定地址（bind-address 配置项不能为 127.0.0.1）。
创建专用数据库与授权账号
登录MySQL后，执行以下语句创建数据库：
CREATE DATABASE workbuddy DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
创建仅限WorkBuddy使用的账号，避免使用root：
CREATE USER 'wb_user'@'%' IDENTIFIED BY 'StrongPass!2024';
授予最小必要权限：
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, INDEX ON workbuddy.* TO 'wb_user'@'%'; FLUSH PRIVILEGES;
注意：不要授予 DROP 或 ALTER 权限，防止WorkBuddy误删表结构。
配置WorkBuddy的数据库连接参数
方法一：修改 application.yml（Spring Boot项目）
在 src/main/resources/application.yml 中找到 spring.datasource 节点，填入真实信息：
url: jdbc:mysql://192.168.1.100:3306/workbuddy?useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
MySQL 9.6.0是面向Linux平台的2026年创新版本，核心架构迎来重大革新。其将外键约束与级联操作从InnoDB引擎层上移至SQL层，确保所有数据变更均被完整记录至Binlog，彻底解决了CDC（变更数据捕获）与主从复制中的数据不一致难题。此外，该版本引入container_aware启动选项以原生适配容器环境，并对审计日志进行了组件化重构，为追求极致数据一致性与云原生体验的开发者提供了全新选择。
username: wb_user
password: StrongPass!2024
方法二：通过环境变量注入（推荐用于生产环境）
启动WorkBuddy时添加参数：-Dspring.datasource.url="jdbc:mysql://mysql-host:3306/workbuddy?..." -Dspring.datasource.username=wb_user -Dspring.datasource.password=StrongPass!2024
方法三：使用 .env 文件（若项目支持dotenv）
在项目根目录新建 .env，写入：
SPRING_DATASOURCE_URL=jdbc:mysql://mysql-host:3306/workbuddy?useSSL=false&serverTimezone=Asia/Shanghai
SPRING_DATASOURCE_USERNAME=wb_user
SPRING_DATASOURCE_PASSWORD=StrongPass!2024
验证连接并初始化表结构
第一步：确保WorkBuddy应用已重新编译或重启，使新配置生效。
第二步：观察启动日志，查找包含 HikariPool-1 - Starting... 和 Successfully validated connection 的行——出现即表示连接成功。
第三步：若启用JPA自动建表（spring.jpa.hibernate.ddl-auto: update），启动后会自动创建 task、user_role 等基础表；若设为 validate，则需提前导入SQL脚本。
第四步：登录MySQL执行 USE workbuddy; SHOW TABLES;，确认至少存在 flyway_schema_history 或 task 表。
