若workbuddy初始化数据库失败且日志提示rds连接拒绝或权限不足，需依次排查：一、确认rds实例运行中、网络连通及端口可达；二、授予服务账号create/drop/insert等数据权限；三、将用户认证插件改为mysql_native_password；四、检查ip白名单与安全组策略；五、校验配置文件中数据库url、字符集及初始化脚本路径。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您启动WorkBuddy时提示初始化数据库失败，且日志中出现“RDS连接拒绝”“用户未授权”或“Access denied for user”等字样，则问题很可能源于RDS实例的访问控制配置异常。以下是针对性排查与修复步骤：
一、验证RDS实例状态与网络连通性
该步骤用于确认RDS服务本身处于可访问状态，并排除基础网络隔离导致的连接中断。若实例已停止、被锁定或跨VPC/地域通信未打通，后续权限配置将无法生效。
1、登录腾讯云控制台，进入RDS实例列表页面。
2、在顶部选择与WorkBuddy部署环境一致的地域。
3、单击目标RDS实例ID，查看实例状态是否为“运行中”；若为“异常”或“锁定”，点击右侧操作栏中的重启按钮执行恢复。
4、在实例详情页左侧导航栏，单击“连接管理”，核对“内网地址”和“数据库端口”是否与WorkBuddy配置文件中填写的host与port完全一致。
5、在WorkBuddy所在服务器（如ECS）上执行telnet命令测试端口可达性：telnet 内网地址 端口号；若返回Connection refused或timeout，需检查安全组入站规则是否放行对应端口，以及ECS与RDS是否处于同一VPC。
二、检查并授予服务账号必要权限
该步骤聚焦于RDS账号体系的最小权限适配。WorkBuddy初始化阶段需执行CREATE DATABASE、CREATE TABLE、INSERT等操作，仅授予SELECT权限将直接导致初始化失败。
1、在RDS实例详情页左侧导航栏，单击“账号管理”。
2、切换至“服务账号”页签，查找用于WorkBuddy连接的数据库账号（通常为非root的专用账号）。
3、在该账号所在行的“权限开通”列，单击滑块确保其处于开启状态。
4、点击滑块右侧的“编辑权限”，在弹出窗口中勾选数据权限（含CREATE、DROP、ALTER、INSERT、UPDATE、DELETE）；若仅勾选“配置权限”，初始化将因缺少建库建表能力而中止。
5、设置授权到期时间为长期有效（如3650天），避免短期授权自动失效引发间歇性失败。
三、校验数据库用户权限与认证方式
该步骤用于识别因MySQL用户权限粒度不足或认证插件不兼容引发的拒绝访问。部分RDS实例默认启用caching_sha2_password插件，而旧版JDBC驱动可能仅支持mysql_native_password。
1、使用具备管理员权限的账号（如root）通过DMS或本地MySQL客户端连接RDS实例。
2、执行SQL语句查询WorkBuddy所用账号的认证方式：SELECT host, user, plugin FROM mysql.user WHERE user = 'workbuddy_user';
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
3、若plugin字段显示为caching_sha2_password，执行以下命令切换为兼容模式：ALTER USER 'workbuddy_user'@'%' IDENTIFIED WITH mysql_native_password BY '当前密码';
4、执行FLUSH PRIVILEGES;使变更立即生效。
5、返回WorkBuddy配置文件，确认数据库URL中未强制指定useSSL=true且未携带allowPublicKeyRetrieval=true参数，避免TLS握手失败干扰初始化流程。
四、排查IP白名单与安全组策略冲突
该步骤用于定位因网络层访问控制过于严格导致的连接静默丢弃。即使账号权限完备，若来源IP未被白名单收录，RDS将在TCP三次握手后直接拒绝应用层请求。
1、在RDS实例“连接管理”页签中，单击“白名单设置”。
2、确认WorkBuddy所在服务器的公网或内网IP已添加至白名单分组；若使用ECS部署，应填写ECS的内网IP而非公网IP。
3、若白名单中存在0.0.0.0/0等宽泛条目，临时移除并仅保留精确IP段，防止其他策略覆盖优先级。
4、进入云服务器ECS控制台，在对应实例的“安全组”页签中，检查入站规则是否允许目标RDS端口（如3306）从该ECS的内网IP发起连接。
5、特别注意：若RDS开启SSL连接，白名单设置仍需生效，SSL仅加密传输内容，不绕过IP校验。
五、重置数据库初始化参数与路径配置
该步骤针对配置文件中数据库路径、字符集或初始化脚本路径错误引发的元数据加载失败。错误的init-connect参数或datadir指向不可写目录，会导致初始化进程在预检阶段退出。
1、定位WorkBuddy配置文件（如application-prod.yml或.env），查找spring.datasource.url字段。
2、确认URL中包含正确的database名称（如?database=workbuddy_db），且该库名未在RDS中被手动删除或重命名。
3、检查是否存在init-sql参数指向本地SQL脚本路径；若路径为绝对路径（如C:\init.sql），需确保该路径在RDS所在服务器上真实存在且可读。
4、验证characterEncoding与serverTimezone参数是否匹配RDS实例的全局配置：characterEncoding=utf8mb4&serverTimezone=Asia/Shanghai为推荐组合。
5、若使用自定义初始化脚本，检查脚本首行是否包含CREATE DATABASE IF NOT EXISTS语句；缺失该语句且目标库不存在时，后续建表语句将因库不存在而批量报错。
