Java MySQL连接案例如何编写

wen java案例 2026-07-01 22

Java MySQL连接案例编写：从零开始的完整指南

📖 目录导读

引言：为什么需要掌握Java连接MySQL？
环境准备：所需工具与依赖
JDBC核心概念解析
手把手：经典Java连接MySQL案例
常见错误与解决方法（问答环节）
连接池优化：从Demo到生产级代码
总结与最佳实践

引言：为什么需要掌握Java连接MySQL？

在Web开发、企业级应用以及大数据场景中，Java与MySQL的交互是最基础也是最核心的技能之一，无论是学生做课程设计，还是工程师开发微服务，都离不开数据库操作，本文将结合搜索引擎中大量实战案例，去伪存真，为你呈现一份“可直接运行的精华手册”。

Java MySQL连接案例如何编写

环境准备：所需工具与依赖

核心工具清单：

JDK 1.8 或更高版本
MySQL Server 5.7+（推荐8.0）
数据库驱动：mysql-connector-java（最新版为 mysql-connector-j）

Maven依赖（pom.xml）：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.33</version> <!-- 根据MySQL版本选择 -->
</dependency>

💡 注意：如果使用MySQL 8.0+，驱动类名需从 com.mysql.jdbc.Driver 改为 com.mysql.cj.jdbc.Driver，并添加时区参数。

JDBC核心概念解析

JDBC（Java Database Connectivity）是Java操作数据库的“标准接口”，其关键环节包括：

加载驱动：向JVM注册数据库驱动类。
建立连接：通过 DriverManager.getConnection(URL, user, password) 获取 Connection 对象。
执行SQL：使用 Statement 或 PreparedStatement 执行查询/更新。
处理结果：ResultSet 遍历数据。
关闭资源：按规定顺序关闭 ResultSet → Statement → Connection。

大多数“连接失败”的问题，根源都在 URL格式错误、驱动版本不匹配 或 防火墙屏蔽。

手把手：经典Java连接MySQL案例

完整代码（可直接复制测试）

import java.sql.*;
public class MySQLConnectionDemo {
    public static void main(String[] args) {
        // 数据库配置（请替换为你的实际值）
        String url = "jdbc:mysql://localhost:3306/testdb?useSSL=false&serverTimezone=UTC";
        String user = "root";
        String password = "your_password";
        Connection conn = null;
        Statement stmt = null;
        ResultSet rs = null;
        try {
            // 1. 加载驱动（MySQL 8.0+）
            Class.forName("com.mysql.cj.jdbc.Driver");
            // 2. 建立连接
            conn = DriverManager.getConnection(url, user, password);
            System.out.println("✅ 数据库连接成功！");
            // 3. 执行查询
            stmt = conn.createStatement();
            String sql = "SELECT id, name, age FROM users LIMIT 5";
            rs = stmt.executeQuery(sql);
            // 4. 处理结果集
            while (rs.next()) {
                int id = rs.getInt("id");
                String name = rs.getString("name");
                int age = rs.getInt("age");
                System.out.println("ID: " + id + ", 姓名: " + name + ", 年龄: " + age);
            }
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            // 5. 关闭资源（顺序不可颠倒）
            try {
                if (rs != null) rs.close();
                if (stmt != null) stmt.close();
                if (conn != null) conn.close();
            } catch (SQLException e) {
                e.printStackTrace();
            }
        }
    }
}

运行前必做检查清单

MySQL服务是否已启动？
数据库 testdb 和表 users 是否存在？
驱动JAR是否已添加到类路径（IDE中需Build Path）？
防火墙是否允许3306端口通信？

常见错误与解决方法（问答环节）

❓ Q1: 报错 `ClassNotFoundException: com.mysql.jdbc.Driver`

原因：驱动类名写错或未导入依赖。
解决：

检查是否将JAR包添加到 classpath。
若使用MySQL 8.0+，类名应为 com.mysql.cj.jdbc.Driver。

❓ Q2: 报错 `CommunicationsException: Communications link failure`

原因：MySQL服务未启动、端口错误、或连接URL中缺少时区参数。
解决：

在URL末尾添加 ?serverTimezone=UTC&useSSL=false。
检查 localhost:3306 是否正确。

❓ Q3: 报错 `Access denied for user 'root'@'localhost'`

原因：用户名或密码错误，或用户权限不足。
解决：

在MySQL命令行执行：ALTER USER 'root'@'localhost' IDENTIFIED BY '新密码';
刷新权限：FLUSH PRIVILEGES;

❓ Q4: 资源泄漏警告

原因：未在finally块中关闭连接。
解决：将关闭操作封装为工具类，或使用Java 7+的 try-with-resources 语法。

连接池优化：从Demo到生产级代码

单次连接在Demo中可用,但在高并发场景下会严重拖垮性能，推荐使用 HikariCP 或 Druid 连接池。

HikariCP配置示例（Spring Boot风格）

import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.HikariDataSource;
HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:mysql://localhost:3306/testdb");
config.setUsername("root");
config.setPassword("your_password");
config.setMaximumPoolSize(10);
config.setConnectionTimeout(30000);
HikariDataSource ds = new HikariDataSource(config);
Connection conn = ds.getConnection(); // 从池中获取

连接池优势：