SpringBoot连接MySQL实战：配置优化与事务管理

1. 项目概述

作为一名长期奋战在一线的Java开发者，我深知SpringBoot与MySQL的组合在企业级应用开发中的重要性。这篇文章将带你深入理解SpringBoot连接MySQL的完整流程，从基础配置到事务机制，再到常见问题排查。不同于简单的配置教程，我会着重分享那些官方文档不会告诉你，但在实际项目中一定会遇到的"坑"。

2. 环境准备与依赖配置

2.1 环境要求

在开始之前，确保你的开发环境满足以下要求：

• 操作系统：Windows 10/11或Linux/macOS（本文以Windows 11为例）
• JDK版本：1.8或更高（推荐OpenJDK 11）
• SpringBoot版本：2.7.x（与3.x版本配置略有不同）
• MySQL版本：8.0.x（与5.x版本有显著差异）
• 构建工具：Maven 3.6+

注意：MySQL 8.x与5.x在驱动类、连接参数等方面有较大变化，这也是很多开发者升级后遇到问题的原因。

2.2 Maven依赖配置

在pom.xml中添加以下依赖：

xml复制<dependencies>
    <!-- Spring JDBC Starter -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-jdbc</artifactId>
    </dependency>

    <!-- MySQL Connector -->
    <dependency>
        <groupId>com.mysql</groupId>
        <artifactId>mysql-connector-j</artifactId>
        <version>8.0.33</version>
        <scope>runtime</scope>
    </dependency>
</dependencies>

关键点解析：

1. spring-boot-starter-jdbc会自动引入Spring JDBC核心组件和HikariCP连接池
2. MySQL 8.x必须使用mysql-connector-j而非老版本的mysql-connector-java
3. 驱动版本建议与MySQL服务器版本匹配，避免兼容性问题

3. 数据库连接配置详解

3.1 application.yml配置

推荐使用YAML格式的配置文件，结构更清晰：

yaml复制spring:
  datasource:
    url: jdbc:mysql://localhost:3306/your_database?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf8
    username: your_username
    password: your_password
    driver-class-name: com.mysql.cj.jdbc.Driver
    hikari:
      maximum-pool-size: 10
      minimum-idle: 5
      connection-timeout: 30000

配置参数解析：

• useSSL=false：开发环境禁用SSL连接
• serverTimezone=Asia/Shanghai：解决MySQL 8时区问题
• characterEncoding=utf8：确保中文支持
• driver-class-name：MySQL 8必须使用cj.jdbc.Driver

3.2 常见配置问题排查

1. 时区错误：MySQL 8默认使用UTC时区，不设置serverTimezone会导致时间相关操作异常
2. SSL警告：开发环境可以禁用SSL，生产环境应配置正确的证书
3. 连接超时：适当调整connection-timeout值，默认30秒可能不够

4. Spring IOC容器管理数据库组件

4.1 自动配置原理

SpringBoot启动时会自动完成以下操作：

1. 根据配置创建DataSource实例（默认使用HikariCP）
2. 创建并注册JdbcTemplate单例Bean
3. 配置事务管理器（PlatformTransactionManager）

4.2 手动配置DataSource

如果需要自定义DataSource，可以这样配置：

java复制@Configuration
public class DataSourceConfig {
    
    @Bean
    @ConfigurationProperties(prefix = "spring.datasource")
    public DataSource dataSource() {
        return DataSourceBuilder.create().build();
    }
    
    @Bean
    public JdbcTemplate jdbcTemplate(DataSource dataSource) {
        return new JdbcTemplate(dataSource);
    }
}

5. 使用JdbcTemplate操作数据库

5.1 基础CRUD操作

java复制@Repository
public class UserRepository {
    
    @Autowired
    private JdbcTemplate jdbcTemplate;
    
    public List<User> findAll() {
        String sql = "SELECT * FROM users";
        return jdbcTemplate.query(sql, (rs, rowNum) -> {
            User user = new User();
            user.setId(rs.getLong("id"));
            user.setName(rs.getString("name"));
            user.setEmail(rs.getString("email"));
            return user;
        });
    }
    
    public int insert(User user) {
        String sql = "INSERT INTO users (name, email) VALUES (?, ?)";
        return jdbcTemplate.update(sql, user.getName(), user.getEmail());
    }
}

5.2 批量操作

java复制public int[] batchInsert(List<User> users) {
    String sql = "INSERT INTO users (name, email) VALUES (?, ?)";
    return jdbcTemplate.batchUpdate(sql, new BatchPreparedStatementSetter() {
        @Override
        public void setValues(PreparedStatement ps, int i) throws SQLException {
            User user = users.get(i);
            ps.setString(1, user.getName());
            ps.setString(2, user.getEmail());
        }
        
        @Override
        public int getBatchSize() {
            return users.size();
        }
    });
}

6. 事务管理实战

6.1 声明式事务配置

java复制@Service
@Transactional
public class UserService {
    
    @Autowired
    private UserRepository userRepository;
    
    public void createUser(User user) {
        userRepository.insert(user);
        // 其他业务逻辑...
    }
}

6.2 事务传播行为

java复制@Transactional(propagation = Propagation.REQUIRED)
public void transactionalMethod() {
    // 业务逻辑...
}

常用传播行为：

• REQUIRED：默认，如果当前没有事务，就新建一个
• REQUIRES_NEW：新建事务，挂起当前事务
• NESTED：嵌套事务
• SUPPORTS：支持当前事务，如果没有则以非事务执行

6.3 事务失效的常见原因

1. 方法访问权限：非public方法上使用@Transactional
2. 自调用问题：同一个类中方法互相调用
3. 异常类型不匹配：默认只回滚RuntimeException
4. 数据库引擎不支持：如使用MyISAM引擎
5. 事务传播行为配置不当

7. 性能优化与最佳实践

7.1 连接池配置优化

yaml复制spring:
  datasource:
    hikari:
      maximum-pool-size: 20
      minimum-idle: 10
      idle-timeout: 30000
      max-lifetime: 1800000
      connection-timeout: 30000
      connection-test-query: SELECT 1

7.2 SQL性能监控

建议在开发环境开启SQL日志：

yaml复制logging:
  level:
    org.springframework.jdbc.core.JdbcTemplate: DEBUG
    org.springframework.jdbc.core.StatementCreatorUtils: TRACE

7.3 使用NamedParameterJdbcTemplate

java复制@Repository
public class UserRepository {
    
    @Autowired
    private NamedParameterJdbcTemplate namedParameterJdbcTemplate;
    
    public List<User> findByName(String name) {
        String sql = "SELECT * FROM users WHERE name = :name";
        Map<String, Object> params = new HashMap<>();
        params.put("name", name);
        return namedParameterJdbcTemplate.query(sql, params, new UserRowMapper());
    }
}

8. 高级特性与扩展

8.1 多数据源配置

java复制@Configuration
public class MultiDataSourceConfig {
    
    @Bean
    @Primary
    @ConfigurationProperties(prefix = "spring.datasource.primary")
    public DataSource primaryDataSource() {
        return DataSourceBuilder.create().build();
    }
    
    @Bean
    @ConfigurationProperties(prefix = "spring.datasource.secondary")
    public DataSource secondaryDataSource() {
        return DataSourceBuilder.create().build();
    }
    
    @Bean
    public JdbcTemplate primaryJdbcTemplate(@Qualifier("primaryDataSource") DataSource dataSource) {
        return new JdbcTemplate(dataSource);
    }
    
    @Bean
    public JdbcTemplate secondaryJdbcTemplate(@Qualifier("secondaryDataSource") DataSource dataSource) {
        return new JdbcTemplate(dataSource);
    }
}

8.2 使用Spring Data JDBC

xml复制<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jdbc</artifactId>
</dependency>

java复制public interface UserRepository extends CrudRepository<User, Long> {
    List<User> findByName(String name);
}

9. 常见问题排查指南

9.1 连接问题

1. Communications link failure

   • 检查MySQL服务是否运行
   • 检查连接URL中的主机名和端口
   • 检查防火墙设置

2. Access denied for user

   • 检查用户名和密码
   • 检查用户权限
   • 检查是否允许远程连接

9.2 时区问题

yaml复制url: jdbc:mysql://localhost:3306/db?serverTimezone=Asia/Shanghai

9.3 编码问题

yaml复制url: jdbc:mysql://localhost:3306/db?characterEncoding=utf8

10. 生产环境建议

1. 使用连接池：HikariCP是SpringBoot默认选择
2. 监控连接泄漏：设置合理的超时时间
3. 定期维护：包括索引优化、表维护等
4. 备份策略：确保数据安全
5. 慢查询日志：监控和优化性能瓶颈

11. 个人实战经验分享

在实际项目开发中，我总结了以下几点经验：

1. 版本一致性：确保开发、测试、生产环境的MySQL版本一致
2. 连接参数：生产环境应启用SSL并配置正确的证书
3. 事务粒度：避免过大事务，合理设置@Transactional的范围
4. 异常处理：明确哪些异常需要回滚事务
5. 连接池监控：使用Spring Boot Actuator监控连接池状态

最后，建议在项目初期就建立完善的数据库访问规范，包括命名约定、事务使用原则等，这将大大减少后期维护成本。