JDBC连接MySQL数据库的具体代码怎么写？

Java数据库连接（JDBC）是Java语言中用于规范客户端程序如何访问数据库的应用程序接口，它为开发者提供了一套标准的API，使得Java程序能够与各种数据库进行交互，本文将详细介绍如何使用JDBC连接MySQL数据库,并提供清晰的代码示例和最佳实践。

第一步：准备工作

在编写连接代码之前,必须确保开发环境已经配置妥当。

1. 安装MySQL数据库：确保你的计算机或服务器上已经安装了MySQL数据库,并且服务正在运行。
2. 创建数据库和用户：在MySQL中创建一个用于测试的数据库（test_db），并为该数据库创建一个具有适当权限的用户，创建一个用户名为 javauser，密码为 password123 的用户，并授予其对 test_db 的所有权限。
3. 获取JDBC驱动程序：JDBC是通过特定数据库的驱动程序来实现连接的，对于MySQL，你需要下载其官方的JDBC驱动，即MySQL Connector/J，你可以从MySQL官方网站下载最新版本的JAR文件（mysql-connector-j-8.x.x.jar），下载后，需要将这个JAR文件添加到你项目的类路径（Classpath）中，如果你使用Maven或Gradle等构建工具,只需在依赖配置中添加相应的坐标即可。

第二步：核心连接代码详解

连接MySQL数据库的核心代码主要包含以下几个关键步骤：加载驱动、定义连接URL、建立连接、执行SQL以及释放资源。

加载驱动

在较旧的JDBC版本中，需要显式加载数据库驱动类,代码如下：

try {
    Class.forName("com.mysql.cj.jdbc.Driver");
} catch (ClassNotFoundException e) {
    e.printStackTrace();
}

从JDBC 4.0开始，只要驱动JAR包在类路径下，这一步通常是可选的，因为DriverManager可以自动发现并加载驱动，但为了代码的兼容性和明确性,保留此步骤仍是一个好习惯。

定义连接信息

连接数据库需要三个核心信息：数据库URL、用户名和密码。

• URL格式：jdbc:mysql://主机名:端口号/数据库名?参数1=值1&参数2=值2
• 示例：jdbc:mysql://localhost:3306/test_db?useSSL=false&serverTimezone=UTC

下表详细解释了URL的各个组成部分：

组成部分	描述	示例值
jdbc:mysql://	协议和子协议，固定写法	jdbc:mysql://
主机名	数据库服务器的地址	localhost (本机) 或 168.1.100
端口号	MySQL服务监听的端口，默认为3306	3306
数据库名	要连接的具体数据库	test_db
参数	连接附加配置，如时区、SSL等	useSSL=false&serverTimezone=UTC

建立连接

使用DriverManager.getConnection()方法来获取与数据库的连接对象（Connection）。

String url = "jdbc:mysql://localhost:3306/test_db?useSSL=false&serverTimezone=UTC";
String user = "javauser";
String password = "password123";
Connection connection = null;
try {
    connection = DriverManager.getConnection(url, user, password);
    System.out.println("数据库连接成功！");
} catch (SQLException e) {
    System.err.println("数据库连接失败！");
    e.printStackTrace();
}

释放资源

数据库连接是非常宝贵的资源，使用完毕后必须关闭，以避免资源泄漏，关闭操作应放在finally块中确保一定能执行，或者使用更现代的try-with-resources语句。

完整代码示例

这是一个使用try-with-resources语法的完整、推荐的连接示例,它可以自动关闭连接。

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;
public class MySqlConnectionExample {
    public static void main(String[] args) {
        String url = "jdbc:mysql://localhost:3306/test_db?useSSL=false&serverTimezone=UTC";
        String user = "javauser";
        String password = "password123";
        // 使用 try-with-resources 自动管理连接，确保在语句结束时关闭连接
        try (Connection connection = DriverManager.getConnection(url, user, password)) {
            if (connection != null) {
                System.out.println("成功连接到MySQL数据库！");
                // 在这里可以创建Statement对象来执行SQL查询
                // Statement statement = connection.createStatement();
                // ResultSet resultSet = statement.executeQuery("SELECT 'Hello, MySQL!'");
                // ...
            }
        } catch (SQLException e) {
            System.err.println("连接MySQL数据库时发生错误。");
            e.printStackTrace();
        }
    }
}

连接最佳实践

• 使用连接池：在生产环境中，频繁地创建和销毁连接会严重影响性能，应使用数据库连接池（如HikariCP、C3P0、Druid）来管理和复用连接。
• 配置外部化：不要将数据库URL、用户名和密码硬编码在代码中，应将它们存储在配置文件（如.properties或.yml）或环境变量中,以提高安全性和灵活性。
• 处理异常：妥善处理SQLException，根据不同的错误码或错误信息进行相应的处理,而不是简单地打印堆栈跟踪。

---

相关问答 (FAQs)

问题1：运行代码时出现 ClassNotFoundException: com.mysql.cj.jdbc.Driver 错误，是什么原因？

解答：这个错误表示Java虚拟机在运行时找不到MySQL的JDBC驱动类，最常见的原因是MySQL Connector/J的JAR文件没有被正确地添加到项目的类路径中,请检查以下几点：

1. 确认已下载：确保你已经从官网下载了对应版本的MySQL Connector/J JAR文件。
2. 添加到类路径：
   • 对于IDE（如IntelliJ IDEA或Eclipse）,需要将JAR文件作为库添加到项目的构建路径中。
   • 对于Maven项目，检查pom.xml文件中的依赖是否正确配置。
   • 对于从命令行运行，需要使用-cp或-classpath参数指定JAR文件的路径。

问题2：连接时遇到 Communications link failure 或 Connection refused 错误，该如何排查？

解答：这类错误通常表示客户端程序无法与MySQL服务器建立网络连接,排查步骤如下：

1. 检查MySQL服务状态：确认MySQL服务是否已经启动，在Linux上可以使用systemctl status mysql或service mysql status命令；在Windows服务管理器中查看MySQL服务是否正在运行。
2. 检查连接信息：仔细核对代码中的URL、主机名和端口号是否正确，默认端口是3306，如果修改过，需要使用正确的端口号，主机名localhost是否正确指向了数据库服务器。
3. 检查防火墙设置：服务器或本地计算机的防火墙可能阻止了对3306端口的访问，需要配置防火墙规则,允许来自你的客户端IP的连接请求。
4. 网络连通性：使用ping命令测试客户端到数据库服务器的网络是否通畅，如果数据库在远程服务器上,确保网络连接没有问题。