JDBC（Java Database Connectivity）是Java语言访问关系型数据库的标准API，几乎所有基于Java的Web应用、后端服务都离不开它。不过在真正写出第一条查询语句之前，环境的正确配置是第一步，也是最容易出问题的一步。很多人明明代码写得没问题，却因为驱动包没导入、数据库服务没启动或者URL写错而反复报错。本文将从环境准备、驱动引入、连接代码编写到常见报错排查，完整走一遍JDBC环境搭建的流程。
一、环境准备：JDK与数据库的安装检查
搭建JDBC环境的第一件事是确认JDK已经正确安装。打开命令行窗口，输入java -version和javac -version，如果两个命令都能输出版本号，说明JDK环境变量配置正常。如果提示“不是内部或外部命令”，需要检查JAVA_HOME、Path这些环境变量是否设置正确。JDK 1.8以后的版本都可以直接使用JDBC 4.0以上的规范，驱动加载方式有了简化，这一点后面会详细说明。
第二件事是确认数据库服务处于运行状态。以MySQL为例，可以在命令行执行net start mysql（Windows环境）查看服务是否启动，或者直接用数据库客户端工具尝试登录一次。同时要记下三个关键信息：数据库主机地址（本机一般是localhost或127.0.0.1）、端口号（MySQL默认3306）、以及一个已经存在的数据库名和账号密码。这些信息在写连接URL时会全部用到，任何一个写错都会导致连接失败。
另外建议提前建一张测试表并插入几条数据，这样连接成功后可以立即验证查询是否正常，避免环境配好了却无数据可查的尴尬。
二、引入数据库驱动：手动导入与Maven两种方式
JDBC本身只是一套接口规范，具体的实现由各个数据库厂商提供的驱动包完成。MySQL的驱动是mysql-connector-java（新版本叫mysql-connector-j），Oracle的驱动是ojdbc8等。获取驱动有两种主流方式。
第一种是手动导入jar包。从官方渠道下载对应数据库的驱动jar文件后，如果使用的是Eclipse，右键项目名，选择Build Path中的Configure Build Path，在Libraries选项卡里点击Add External JARs，选中下载好的jar包即可。如果是IDEA，则进入Project Structure，在Modules的Dependencies面板中添加jar包路径。手动导入方式适合学习阶段的小项目，缺点是换一台机器就要重新配置一遍。
第二种是使用Maven管理依赖，这是目前更推荐的做法。在项目的pom.xml中加入如下依赖：
<dependency>
<groupId>com.mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
<version>8.0.33</version>
</dependency>
保存后Maven会自动下载驱动到本地仓库，项目构建时自动打包，团队协作时其他人拉取代码即可直接编译运行，不需要手动复制jar包。如果是Oracle数据库，把依赖换成com.oracle.database.jdbc:ojdbc8即可，其余步骤完全一致。
三、编写连接代码：自动加载与Class.forName的区别
驱动导入后，接下来写连接代码。这里有一个很多老教程没讲清楚的点：在JDBC 4.0之前，必须手动加载驱动类，也就是执行Class.forName("com.mysql.jdbc.Driver")；而从JDBC 4.0开始，驱动jar包内部通过SPI机制（在META-INF/services目录下注册驱动实现）实现了自动加载，只要驱动jar在classpath中，直接调用DriverManager获取连接即可，不需要再写Class.forName这一行。
注意驱动类名随版本有变化：MySQL 5.x时代是com.mysql.jdbc.Driver，8.x版本改成了com.mysql.cj.jdbc.Driver，而且新版本URL中必须显式声明时区参数，否则会报时区异常。下面是一段完整的测试代码：
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.ResultSet;
import java.sql.Statement;
public class JdbcTest {
public static void main(String[] args) throws Exception {
// JDBC 4.0之后无需手动Class.forName，驱动自动加载
String url = "jdbc:mysql://localhost:3306/testdb?useSSL=false&serverTimezone=Asia/Shanghai";
String user = "root";
String password = "123456";
try (Connection conn = DriverManager.getConnection(url, user, password);
Statement stmt = conn.createStatement();
ResultSet rs = stmt.executeQuery("SELECT id, name FROM user")) {
while (rs.next()) {
System.out.println(rs.getInt("id") + " - " + rs.getString("name"));
}
} // try-with-resources会自动关闭连接，无需手动close
}
}
这段代码用了try-with-resources语法，连接、语句、结果集都会自动关闭，避免了资源泄漏。URL的格式遵循jdbc:数据库类型://主机:端口/数据库名?参数的结构，不同数据库的参数项不一样，比如Oracle的URL格式是jdbc:oracle:thin:@localhost:1521:orcl。
四、常见报错排查思路
环境搭建过程中最常见的错误是java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver，这几乎一定是驱动jar没有正确进入classpath。用Maven的项目执行一次mvn clean compile确认依赖下载成功；手动导入的项目检查Build Path里jar是否有红色感叹号或缺失标记。
其次是Access denied for user，这是账号密码错误或者该账号没有远程访问权限。可以在数据库端执行授权语句，或者确认密码中没有多余的空格。如果报Communications link failure或连接超时，依次检查数据库服务是否启动、端口号是否正确、防火墙是否放行了对应端口。
还有一个高频问题是时区报错，提示The server time zone value...，解决办法就是在URL后面追加serverTimezone=Asia/Shanghai参数，上面代码中已经包含了这一项。遇到报错时先读完整堆栈信息，定位到第一行由自己代码触发的异常，再对照官方文档排查，比盲目搜索效率高得多。按照以上步骤配置完成后，你的第一个JDBC连接程序就可以稳定跑起来了。