共计 2400 个字符，预计需要花费 6 分钟才能阅读完成。
开篇：那些年我们踩过的 MySQL 连接坑
最近在 Claude Code 项目中集成 MySQL 数据库时，发现新手常会遇到三类典型问题：
- 驱动版本不兼容 ：比如用 MySQL 8.x 驱动连接 5.7 服务端时出现的
Public Key Retrieval is not allowed错误 - SSL 配置冲突：本地开发环境未配置 SSL 证书导致的
SSLHandshakeException - 连接泄漏 ：未正确关闭 Connection 引发
Too many connections的经典错误
技术选型：连接方案对比
| 方案 | 适用场景 | 优缺点对比 |
|---|---|---|
| 原生 JDBC | 快速原型验证 | 需手动管理连接，易资源泄漏 |
| HikariCP | 生产环境高并发场景 | 性能最优，监控完善 |
| MyBatis | 需要 ORM 映射的复杂业务 | 学习曲线较陡 |
推荐组合方案：HikariCP + 预处理语句，平衡性能与安全性
核心实现四步走
1. 依赖配置（Maven 示例）
<!-- pom.xml 关键片段 -->
<dependencies>
<!-- MySQL 驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.28</version>
<scope>runtime</scope>
</dependency>
<!-- HikariCP 连接池 -->
<dependency>
<groupId>com.zaxxer</groupId>
<artifactId>HikariCP</artifactId>
<version>5.0.1</version>
</dependency>
</dependencies>2. 连接池配置类
// DatabaseConfig.java
public class DatabaseConfig {
private static HikariDataSource dataSource;
static {HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:mysql://localhost:3306/claude_db?useSSL=false");
config.setUsername("app_user");
config.setPassword("secureP@ss123");
// 生产环境关键参数（建议通过环境变量注入）config.setMaximumPoolSize(20);
config.setConnectionTimeout(30000);
config.setIdleTimeout(600000);
config.setMaxLifetime(1800000);
dataSource = new HikariDataSource(config);
}
public static Connection getConnection() throws SQLException {return dataSource.getConnection();
}
}3. 带资源管理的查询示例
// UserDAO.java
public List<User> getActiveUsers() {
String sql = "SELECT * FROM users WHERE status = ?";
List<User> users = new ArrayList<>();
try (Connection conn = DatabaseConfig.getConnection();
PreparedStatement stmt = conn.prepareStatement(sql)) {stmt.setString(1, "active"); // 防 SQL 注入
ResultSet rs = stmt.executeQuery();
while (rs.next()) {
users.add(new User(rs.getInt("id"),
rs.getString("username")
));
}
} catch (SQLException e) {
// 建议使用 SLF4J 记录日志
logger.error("查询用户失败", e);
throw new RuntimeException(e);
}
return users;
}4. 生产环境优化配置
- 连接存活检测：
config.addDataSourceProperty("testWhileIdle", "true") - 泄漏回收：
config.setLeakDetectionThreshold(60000) - 网络重试（需配合 Spring Retry）：
@Retryable(maxAttempts=3, backoff=@Backoff(delay=1000))
public Connection getConnectionWithRetry() throws SQLException {return dataSource.getConnection();
}安全规范黄金法则
- 永远使用 PreparedStatement：杜绝字符串拼接 SQL
- 敏感配置加密：
- 开发环境：使用 jasypt 加密密码
- 生产环境：推荐 Vault 或 KMS 服务
- 最小权限原则：数据库账号只授予必要权限
避坑实战经验
时区问题解决方案
在连接字符串追加参数：
&serverTimezone=Asia/Shanghai&useLegacyDatetimeCode=false
大结果集处理技巧
// 流式读取避免 OOM
stmt.setFetchSize(100);
ResultSet rs = stmt.executeQuery();
while (rs.next()) {// 逐行处理}进阶思考
当我们需要实现跨可用区（AZ）的数据库故障转移时，除了常规的主从切换，还需要考虑：
1. 如何检测节点故障？
2. 切换期间的事务如何处理？
3. 客户端如何感知新端点？
欢迎在评论区分享你的设计方案！
正文完
