JDBC 连接 MySQL 数据库完整入门步骤

博主：小蓝
发布时间：2025 年 08 月 18 日
92 次浏览
暂无评论
6973字数
分类： Linux 技术杂烩

### JDBC 连接 MySQL 数据库完整入门步骤

JDBC（Java Database Connectivity）是Java操作数据库的标准API，掌握其连接MySQL的流程是后端开发的核心技能。本文以**最新MySQL 8.0+** 和**JDBC 4.3**规范为基础，通过代码实操演示全流程，包含避坑指南和可视化流程图。😊

---

### 一、环境准备（共三步）

#### 1. 安装MySQL服务器

```bash
# Ubuntu示例（其他系统参考官网）
sudo apt update
sudo apt install mysql-server

# 验证安装
mysql --version  # 应显示8.0.x
```

#### 2. 创建测试数据库

```sql
-- 登录MySQL
mysql -u root -p

-- 创建数据库和用户
CREATE DATABASE jdbc_test;
CREATE USER 'java_user'@'localhost' IDENTIFIED BY 'SecurePass123!';
GRANT ALL PRIVILEGES ON jdbc_test.* TO 'java_user'@'localhost';
FLUSH PRIVILEGES;

-- 创建测试表
USE jdbc_test;
CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(50) NOT NULL,
    email VARCHAR(100) UNIQUE
);
```

#### 3. 添加MySQL驱动

**Maven项目**（pom.xml）：

```xml
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.33</version> 
</dependency>
```

**手动添加**：
从[MySQL官网]下载 `mysql-connector-java-8.0.33.jar`，放入项目 `lib`目录

---

### 二、JDBC核心连接流程（六步法）

```mermaid
graph TD
    A[加载驱动] --> B[建立连接]
    B --> C[创建Statement]
    C --> D[执行SQL]
    D --> E[处理结果]
    E --> F[关闭连接]
```

#### 步骤1：加载驱动（Java 6+自动加载）

```java
// 显式加载驱动（兼容旧版本）
Class.forName("com.mysql.cj.jdbc.Driver");
```

**解释**：

* `com.mysql.cj.jdbc.Driver`：MySQL 8.x的驱动类名
* Java 6+支持**SPI机制**，可省略此步

#### 步骤2：建立连接

```java
String url = "jdbc:mysql://localhost:3306/jdbc_test?useSSL=false&serverTimezone=Asia/Shanghai";
String user = "java_user";
String password = "SecurePass123!";

try (Connection conn = DriverManager.getConnection(url, user, password)) {
    System.out.println("连接成功！");
}
```

**参数详解**：

| 组件                     | 示例值                              | 作用                |
| ------------------------ | ----------------------------------- | ------------------- |
| **URL**            | `jdbc:mysql://主机:端口/数据库名` | 定位数据库          |
| **useSSL**         | `false`                           | 禁用SSL（测试环境） |
| **serverTimezone** | `Asia/Shanghai`                   | 避免时区错误        |

> 生产环境必须启用SSL：`useSSL=true&requireSSL=true`

#### 步骤3：创建Statement

```java
// 创建简单Statement
Statement stmt = conn.createStatement();

// 创建PreparedStatement（防SQL注入）
String sql = "INSERT INTO users (name, email) VALUES (?, ?)";
PreparedStatement pstmt = conn.prepareStatement(sql);
```

**选择策略**：

* 静态SQL → `Statement`
* 动态参数 → **PreparedStatement**（99%场景推荐）

#### 步骤4：执行SQL

```java
// 执行INSERT/UPDATE/DELETE
pstmt.setString(1, "张三");  // 替换第一个?
pstmt.setString(2, "zhangsan@example.com");
int rows = pstmt.executeUpdate();  // 返回影响行数

// 执行SELECT查询
ResultSet rs = stmt.executeQuery("SELECT * FROM users");
```

#### 步骤5：处理结果集

```java
while (rs.next()) {
    int id = rs.getInt("id");
    String name = rs.getString("name");
    String email = rs.getString("email");
    System.out.printf("ID: %d, 姓名: %s, 邮箱: %s%n", id, name, email);
}
```

**关键方法**：

* `rs.next()`：移动游标到下一行
* `getXxx("列名")`：按类型获取数据

#### 步骤6：关闭资源

```java
try {
    if (rs != null) rs.close();
    if (stmt != null) stmt.close();
    if (conn != null) conn.close();
} catch (SQLException e) {
    e.printStackTrace();
}
```

**优化方案**：
使用**try-with-resources**自动关闭：

```java
try (Connection conn = DriverManager.getConnection(url, user, password);
     PreparedStatement pstmt = conn.prepareStatement(sql)) {
    // 操作代码...
}  // 自动关闭conn和pstmt
```

---

### 三、完整代码示例

```java
import java.sql.*;

public class JdbcDemo {
    public static void main(String[] args) {
        String url = "jdbc:mysql://localhost:3306/jdbc_test?useSSL=false&serverTimezone=UTC";
        String user = "java_user";
        String password = "SecurePass123!";
    
        // 1. 自动加载驱动 + 2.建立连接
        try (Connection conn = DriverManager.getConnection(url, user, password);
             // 3. 创建PreparedStatement
             PreparedStatement pstmt = conn.prepareStatement(
                 "INSERT INTO users (name, email) VALUES (?, ?)")) {
        
            // 4. 设置参数并执行
            pstmt.setString(1, "李四");
            pstmt.setString(2, "lisi@example.com");
            int affectedRows = pstmt.executeUpdate();
            System.out.println("插入完成，影响行数: " + affectedRows);
        
            // 5. 查询验证
            Statement stmt = conn.createStatement();
            ResultSet rs = stmt.executeQuery("SELECT * FROM users");
            while (rs.next()) {
                System.out.println(
                    "ID: " + rs.getInt("id") + 
                    ", 姓名: " + rs.getString("name")
                );
            }
        } catch (SQLException e) {  // 6. 异常处理
            System.err.println("数据库错误: " + e.getMessage());
        }
    }
}
```

---

### 四、常见错误与解决方案

| 错误信息                                       | 原因                    | 解决方案                                              |
| ---------------------------------------------- | ----------------------- | ----------------------------------------------------- |
| `No suitable driver`                         | URL格式错误或驱动未加载 | 检查URL拼写，确认驱动jar在类路径                      |
| `Access denied for user`                     | 用户名/密码错误         | 复查权限：`SHOW GRANTS FOR 'java_user'@'localhost'` |
| `The server time zone value is unrecognized` | 时区配置缺失            | URL添加 `?serverTimezone=Asia/Shanghai`             |
| `Public Key Retrieval is not allowed`        | MySQL 8.x加密问题       | URL添加 `allowPublicKeyRetrieval=true`              |
| `Connection refused`                         | 数据库未启动/端口错误   | `sudo systemctl status mysql`检查服务状态           |

---

### 五、高级技巧与最佳实践

#### 1. 连接池配置（如HikariCP）

```java
HikariConfig config = new HikariConfig();
config.setJdbcUrl(url);
config.setUsername(user);
config.setPassword(password);
config.setMaximumPoolSize(10);  // 最大连接数

try (HikariDataSource ds = new HikariDataSource(config);
     Connection conn = ds.getConnection()) {
    // 使用连接...
}
```

**优势**：减少连接开销，提升性能300%+

#### 2. 事务管理

```java
conn.setAutoCommit(false);  // 关闭自动提交
try {
    // 执行多个SQL...
    conn.commit();  // 提交事务
} catch (SQLException e) {
    conn.rollback();  // 回滚事务
}
```

#### 3. 数据类型映射表

| SQL类型  | Java类型                | JDBC方法    |
| -------- | ----------------------- | ----------- |
| INT      | int                     | getInt()    |
| VARCHAR  | String                  | getString() |
| DATETIME | java.time.LocalDateTime | getObject() |
| BLOB     | byte[]                  | getBytes()  |

---

### 六、总结：JDBC工作流程图

```mermaid
graph LR
    A[Java应用] --> B[JDBC接口]
    B --> C[DriverManager]
    C --> D[MySQL驱动]
    D --> E[MySQL数据库]
    E --> F[返回结果]
    F --> B
```

**核心要点**：

1. **连接字符串**：MySQL 8.x必须指定时区
2. **资源管理**：使用try-with-resources自动关闭
3. **安全优先**：生产环境强制开启SSL
4. **性能优化**：用连接池代替直连

遵循此指南，你已掌握JDBC操作MySQL的核心技能！🚀 据统计，正确使用连接池可使数据库操作性能提升5倍以上（来源：Oracle官方性能报告）。建议结合Spring JPA等框架简化日常开发。

蓝易云是一家专注于香港及国内数据中心服务的提供商，提供高质量的服务器租用和云计算服务、包括免备案香港服务器、香港CN2、美国服务器、海外高防服务器、国内高防服务器、香港VPS等。致力于为用户提供稳定,快速的网络连接和优质的客户体验。

最后修改：2025 年 08 月 18 日

如果觉得我的文章对你有用，请随意赞赏

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

评论 *

私密评论

名称 *

🎲

邮箱 *

地址

JDBC 连接 MySQL 数据库完整入门步骤

小蓝 • 2025 年 08 月 18 日

### JDBC 连接 MySQL 数据库完整入门步骤

---

### 一、环境准备（共三步）

#### 1. 安装MySQL服务器

```bash
# Ubuntu示例（其他系统参考官网）
sudo apt update
sudo apt install mysql-server

# 验证安装
mysql --version  # 应显示8.0.x
```

#### 2. 创建测试数据库

```sql
-- 登录MySQL
mysql -u root -p

-- 创建测试表
USE jdbc_test;
CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(50) NOT NULL,
    email VARCHAR(100) UNIQUE
);
```

#### 3. 添加MySQL驱动

**Maven项目**（pom.xml）：

```xml
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.33</version> 
</dependency>
```

**手动添加**：
从[MySQL官网]下载 `mysql-connector-java-8.0.33.jar`，放入项目 `lib`目录

---

### 二、JDBC核心连接流程（六步法）

```mermaid
graph TD
    A[加载驱动] --> B[建立连接]
    B --> C[创建Statement]
    C --> D[执行SQL]
    D --> E[处理结果]
    E --> F[关闭连接]
```

#### 步骤1：加载驱动（Java 6+自动加载）

```java
// 显式加载驱动（兼容旧版本）
Class.forName("com.mysql.cj.jdbc.Driver");
```

**解释**：

* `com.mysql.cj.jdbc.Driver`：MySQL 8.x的驱动类名
* Java 6+支持**SPI机制**，可省略此步

#### 步骤2：建立连接

```java
String url = "jdbc:mysql://localhost:3306/jdbc_test?useSSL=false&serverTimezone=Asia/Shanghai";
String user = "java_user";
String password = "SecurePass123!";

try (Connection conn = DriverManager.getConnection(url, user, password)) {
    System.out.println("连接成功！");
}
```

**参数详解**：

> 生产环境必须启用SSL：`useSSL=true&requireSSL=true`

#### 步骤3：创建Statement

```java
// 创建简单Statement
Statement stmt = conn.createStatement();

// 创建PreparedStatement（防SQL注入）
String sql = "INSERT INTO users (name, email) VALUES (?, ?)";
PreparedStatement pstmt = conn.prepareStatement(sql);
```

**选择策略**：

* 静态SQL → `Statement`
* 动态参数 → **PreparedStatement**（99%场景推荐）

#### 步骤4：执行SQL

```java
// 执行INSERT/UPDATE/DELETE
pstmt.setString(1, "张三");  // 替换第一个?
pstmt.setString(2, "zhangsan@example.com");
int rows = pstmt.executeUpdate();  // 返回影响行数

// 执行SELECT查询
ResultSet rs = stmt.executeQuery("SELECT * FROM users");
```

#### 步骤5：处理结果集

**关键方法**：

* `rs.next()`：移动游标到下一行
* `getXxx("列名")`：按类型获取数据

#### 步骤6：关闭资源

```java
try {
    if (rs != null) rs.close();
    if (stmt != null) stmt.close();
    if (conn != null) conn.close();
} catch (SQLException e) {
    e.printStackTrace();
}
```

**优化方案**：
使用**try-with-resources**自动关闭：

```java
try (Connection conn = DriverManager.getConnection(url, user, password);
     PreparedStatement pstmt = conn.prepareStatement(sql)) {
    // 操作代码...
}  // 自动关闭conn和pstmt
```

---

### 三、完整代码示例

```java
import java.sql.*;

---

### 四、常见错误与解决方案

---

### 五、高级技巧与最佳实践

#### 1. 连接池配置（如HikariCP）

```java
HikariConfig config = new HikariConfig();
config.setJdbcUrl(url);
config.setUsername(user);
config.setPassword(password);
config.setMaximumPoolSize(10);  // 最大连接数

try (HikariDataSource ds = new HikariDataSource(config);
     Connection conn = ds.getConnection()) {
    // 使用连接...
}
```

**优势**：减少连接开销，提升性能300%+

#### 2. 事务管理

```java
conn.setAutoCommit(false);  // 关闭自动提交
try {
    // 执行多个SQL...
    conn.commit();  // 提交事务
} catch (SQLException e) {
    conn.rollback();  // 回滚事务
}
```

#### 3. 数据类型映射表

---

### 六、总结：JDBC工作流程图

```mermaid
graph LR
    A[Java应用] --> B[JDBC接口]
    B --> C[DriverManager]
    C --> D[MySQL驱动]
    D --> E[MySQL数据库]
    E --> F[返回结果]
    F --> B
```

**核心要点**：

JDBC 连接 MySQL 数据库完整入门步骤

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

微信视频号视频下载工具WeChatVideoDownloader

Win11系统优化工具-Windows11一键设置

YDArk - 系统内核工具

XPay-自建个人免签收款支付系统

Windows微软常用运行库合集一键安装

应用层：客户-服务器方式(C/S)、对等方式(P2P)

ConcurrentLinkedQueue详解

微服务Docker镜像集成SkyWalking监控指南

Spring Boot实战：控制器如何优雅返回JSON数据

Redis模糊查询结合MP数据获取

JDBC 连接 MySQL 数据库完整入门步骤

发表评论 取消回复 使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

JDBC 连接 MySQL 数据库完整入门步骤

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款