Spring MVC Boot无法连接MySQL：终端无报错但连接失败求助

1. 验证连接是否真的未建立 #

Spring Boot默认的Hikari连接池是懒加载机制，启动阶段不会主动创建数据库连接，只有首次执行SQL操作时才会触发连接建立。可以添加一段启动时的验证逻辑：

@Component
public class ConnectionValidator implements ApplicationRunner {
    @Autowired
    private JdbcTemplate jdbcTemplate;

    @Override
    public void run(ApplicationArguments args) throws Exception {
        // 执行简单SQL触发连接创建
        Integer result = jdbcTemplate.queryForObject("SELECT 1", Integer.class);
        System.out.println("MySQL连接已成功建立，测试SQL结果：" + result);
    }
}

或者修改连接池配置强制初始化：

spring.datasource.hikari.initialization-fail-timeout=5000

该配置会让连接池在启动时尝试创建连接，失败则直接抛出异常，避免“假正常”的情况。

2. 核对连接配置细节 #

仔细检查application.properties中的核心配置，不要忽略细节：

• spring.datasource.url：确认端口、数据库名、时区、SSL配置是否正确，比如MySQL 8.0+必须指定时区：jdbc:mysql://localhost:3306/your_db?serverTimezone=Asia/Shanghai&useSSL=false
• spring.datasource.username/spring.datasource.password：核对账号密码的大小写、特殊字符，确保和数据库端完全匹配
• spring.datasource.driver-class-name：MySQL 8.0+用com.mysql.cj.jdbc.Driver，5.x版本用com.mysql.jdbc.Driver，不要混淆

3. 开启详细日志排查 #

默认日志级别无法展示连接细节，修改日志配置输出调试信息：

logging.level.com.zaxxer.hikari=DEBUG
logging.level.org.springframework.jdbc=DEBUG
logging.level.com.mysql.cj.jdbc=DEBUG

启动后查看日志，能看到连接池初始化、连接尝试的完整过程，即使没有报错，也能确认是否真的发起了连接请求。

4. 检查数据库端状态 #

• 登录MySQL服务器执行SHOW PROCESSLIST;，查看是否有来自应用服务器的连接记录
• 确认数据库防火墙/安全组是否开放3306端口给应用服务器IP
• 如果是远程连接，检查数据库用户是否拥有远程访问权限：

GRANT ALL PRIVILEGES ON your_db.* TO 'your_user'@'%' IDENTIFIED BY 'your_password';
FLUSH PRIVILEGES;

5. 确认依赖版本兼容性 #

检查pom.xml中依赖的兼容性：

• Spring Boot 2.x搭配mysql-connector-java 8.0.x版本；Spring Boot 3.x需要使用mysql-connector-j（artifactId已变更）
• 执行mvn dependency:tree查看是否存在多版本驱动或连接池依赖冲突

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