Java连接SQL Server数据库教程（2025最新版）：从零开始，五步搞定！
Meta Description:
本文是2025年最新的Java连接SQL Server数据库详细教程，内容涵盖环境准备（JDBC驱动下载与配置）、核心代码实现（Connection、Statement、ResultSet）、常见问题解决（如连接失败、驱动类名错误）以及最佳实践（连接池使用），无论你是Java新手还是需要回顾的开发者，这份手把手教程都能帮你快速掌握Java操作SQL Server数据库,轻松解决连接难题！
Java连接SQL Server数据库教程（2025最新版）：从零开始，五步搞定！
作为一名Java开发者，连接数据库是后端开发中一项至关重要的基础技能，SQL Server作为微软公司推出的主流关系型数据库，在众多企业级应用中扮演着核心角色，本文将为你提供一份详尽、清晰、可操作性强的Java连接SQL Server数据库教程,带你一步步攻克这个技术难关。
准备工作：工欲善其事，必先利其器
在开始编码之前,我们需要确保开发环境已经准备就绪。
1 环境清单
- JDK (Java Development Kit): 确保你的电脑上已安装JDK（推荐JDK 8或更高版本），并正确配置了
JAVA_HOME环境变量。 - IDE (集成开发环境): IntelliJ IDEA、Eclipse或VS Code等，本文以IntelliJ IDEA为例进行演示。
- SQL Server数据库: 确保你的SQL Server服务正在运行，你需要知道以下连接信息：
- 服务器地址:
localhost（本地）或IP地址。 - 端口号: 默认为
1433。 - 数据库名称: 你要连接的数据库，例如
TestDB。 - 用户名和密码: 具有访问该数据库权限的账户。
- 服务器地址:
2 下载并配置SQL Server JDBC驱动
Java程序通过JDBC（Java Database Connectivity）规范来与数据库交互，而SQL Server官方提供了专门的JDBC驱动程序,这是连接的桥梁。
【核心步骤】
-
下载驱动：
- 访问微软官方JDBC驱动下载页面：Microsoft JDBC Drivers for SQL Server
- 根据你的JDK版本选择合适的驱动包，对于大多数情况，下载 "Microsoft JDBC Driver for SQL Server" 的最新版本即可。
- 下载的是一个
.zip压缩包，解压后会看到几个.jar文件，我们需要的是mssql-jdbc-<version>.jar这个文件（具体名称可能因版本而异）。
-
配置驱动到项目：
- IntelliJ IDEA:
- 打开你的项目，进入
File->Project Structure...。 - 选择
Modules->Dependencies选项卡。 - 点击右侧的 号，选择
JARs or directories...。 - 找到并选中你刚刚下载的
mssql-jdbc-<version>.jar文件，点击OK。 - 确保驱动已添加到你的模块依赖中，点击
Apply和OK保存。
- 打开你的项目，进入
- IntelliJ IDEA:
核心代码实现：五步搞定连接
准备工作就绪，现在我们开始编写Java代码，我们将创建一个简单的Java类，演示如何连接到SQL Server,并执行一个查询语句。
【核心五步】
- 加载JDBC驱动类。
- 创建数据库连接URL。
- 获取数据库连接对象。
- 创建执行SQL语句的对象。
- 处理结果集并释放资源。
下面是一个完整的、可运行的示例代码：
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.ResultSet;
import java.sql.Statement;
import java.sql.SQLException;
public class ConnectSQLServer {
public static void main(String[] args) {
// --- 【第一步：定义连接信息】---
// 注意：如果SQL Server开启了SSL加密，这里需要添加 encrypt=true;trustServerCertificate=true; 等参数
String dbUrl = "jdbc:sqlserver://localhost:1433;databaseName=TestDB;encrypt=false;trustServerCertificate=false;loginTimeout=30;";
String dbUser = "sa"; // 你的SQL Server用户名
String dbPassword = "your_password"; // 你的SQL Server密码
Connection conn = null;
Statement stmt = null;
ResultSet rs = null;
try {
// --- 【第二步：加载JDBC驱动】---
// 这是旧版JDBC 4.0之前的方式，现在新版驱动通常自动加载，但显式写出更清晰
// Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
// --- 【第三步：获取数据库连接】---
System.out.println("正在尝试连接到SQL Server...");
conn = DriverManager.getConnection(dbUrl, dbUser, dbPassword);
System.out.println("连接成功！");
// --- 【第四步：创建Statement对象并执行SQL查询】---
stmt = conn.createStatement();
String sql = "SELECT id, name, email FROM Users";
rs = stmt.executeQuery(sql);
// --- 【第五步：处理结果集】---
System.out.println("\n--- 查询结果 ---");
while (rs.next()) {
// 通过列名或列索引获取数据，推荐使用列名，更具可读性
int id = rs.getInt("id");
String name = rs.getString("name");
String email = rs.getString("email");
// 输出结果
System.out.println("ID: " + id + ", 姓名: " + name + ", 邮箱: " + email);
}
} catch (SQLException e) {
// --- 【重要：处理异常】---
System.err.println("数据库操作发生错误！");
e.printStackTrace();
} finally {
// --- 【重要：释放资源】---
// 为了确保资源被释放，必须使用try-catch-finally块
try {
if (rs != null) rs.close();
if (stmt != null) stmt.close();
if (conn != null) conn.close();
System.out.println("\n数据库连接已关闭。");
} catch (SQLException e) {
e.printStackTrace();
}
}
}
}
代码详解与关键点解析
-
dbUrl(连接字符串):jdbc:sqlserver://: 固定协议，表示使用SQL Server的JDBC驱动。localhost:1433: 服务器地址和端口号。databaseName=TestDB: 指定要连接的数据库。encrypt=false;: 在本地开发或非生产环境中，可以禁用加密以简化连接，在生产环境中,请务必启用安全连接。trustServerCertificate=false;: 用于验证服务器证书，设为true可以绕过证书验证,仅用于开发测试。
-
Class.forName(...):在JDBC 4.0规范（JDK 6及以上）中，驱动程序会自动注册，这行代码在现代开发中通常是可选的，但保留它可以让代码在更广泛的环境中兼容,并且能清晰地表明我们正在加载驱动。
-
DriverManager.getConnection(...):这是建立连接的核心方法，它接收三个参数：连接URL、用户名和密码。
-
try-catch-finally与资源释放:- 这是最重要的最佳实践之一！
Connection,Statement, 和ResultSet都是有限的系统资源,用完后必须关闭。 - 将关闭逻辑放在
finally块中，可以确保即使发生异常，资源也能被正确释放,避免资源泄漏。 - 关闭顺序与创建顺序相反：先关闭
ResultSet，再关闭Statement，最后关闭Connection。
- 这是最重要的最佳实践之一！
常见问题与解决方案（FAQ）
Q1: 运行时提示 "No suitable driver found for jdbc:sqlserver://..."
- 原因: 最常见的原因是 JDBC驱动包没有正确添加到项目的Classpath中，IDE没有识别到
mssql-jdbc.jar文件。 - 解决方案:
- 重新检查项目依赖中是否已添加驱动
.jar文件。 - 如果使用Maven或Gradle，请确保
pom.xml或build.gradle文件中依赖正确，并执行刷新/同步操作。
- 重新检查项目依赖中是否已添加驱动
