Spring Boot（STS）项目连接MySQL数据库报错的排查咨询

• 基础连接配置错漏核查
  • 校验JDBC连接参数格式：MySQL 8.0及以上版本的连接URL必须携带serverTimezone=Asia/Shanghai时区参数，缺失会直接触发时区解析异常；未配置SSL证书的本地连接需追加useSSL=false，否则会出现SSL握手失败报错。同时确认端口、库名与本地MySQL实际配置一致，目标数据库需要提前在实例中创建完成，不存在的库会被直接拒绝连接
  • 校验账号权限：确认配置的数据库账号拥有对应库的访问权限，排除账号仅允许本地主机登录、但鉴权校验逻辑拦截连接请求的问题
  • 排查网络与服务状态：确认MySQL服务处于运行状态，本地防火墙、安全软件未拦截对应端口的出入站请求
• 依赖版本与冲突排查
  • 匹配驱动版本：项目引入的mysql-connector-java驱动版本需要和本地MySQL大版本对齐，MySQL 8.0及以上版本必须使用8.x版本驱动，5.x版本驱动不兼容8.0版本的新鉴权协议。使用Spring Boot 2.x及以上版本时，可直接通过父依赖管理驱动版本，无需手动指定版本号避免版本错配
  • 排除类路径冲突：在STS的启动日志中检查类加载路径，确认是否存在多版本MySQL驱动、连接池依赖混杂的情况，类加载顺序异常会直接导致连接初始化失败
• 连接池参数适配排查
  • 若使用HikariCP、Druid等内置连接池组件，检查是否配置了过短的连接超时阈值，项目启动阶段数据库初始化耗时超过阈值时，会直接抛出连接失败异常
  • 确认是否配置了不合理的空闲连接回收参数，避免连接池提前销毁有效连接触发报错
• 堆栈精准定位排错
  • 从报错堆栈的最底层根因段定位异常类型，针对性解决：
    • 出现Communications link failure类异常，优先排查端口连通性、MySQL服务状态、网络拦截问题
    • 出现Access denied类异常，优先核对账号密码、账号访问权限配置
    • 出现Unknown database类异常，优先核对JDBC URL中配置的数据库名是否存在

内容的提问来源于stack exchange，提问作者shin0707