在Java Web开发领域，JSP（JavaServer Pages）技术作为一种动态网页技术标准，其核心价值在于能够将Java代码嵌入HTML页面中，从而实现服务器端的动态内容生成，而绝大多数Web应用都需要与数据库进行交互，以实现数据的持久化存储、查询、更新和删除，掌握JSP如何连接数据库是每一位Java Web开发者的必备技能，本文将系统、清晰地阐述JSP连接数据库的全过程，从核心原理到具体实现，并辅以最佳实践,旨在为读者提供一份全面而实用的指南。
核心基石：JDBC技术
在深入探讨JSP如何连接数据库之前，必须首先理解其背后的核心技术——JDBC（Java Database Connectivity），JDBC是一套由Java定义的、用于执行SQL语句的Java API，它为多种关系型数据库提供了统一访问接口，JDBC并不直接与数据库交互，而是通过数据库厂商提供的特定JDBC驱动程序（Driver）作为桥梁，开发者使用标准的JDBC API编写代码，而具体的数据库通信细节则由对应的驱动程序负责处理，这种设计模式实现了Java应用与特定数据库的解耦，使得更换数据库时,通常只需更换相应的JDBC驱动和连接字符串即可。
JDBC的核心工作流程通常包含以下几个关键步骤：
- 加载驱动：将数据库厂商提供的JDBC驱动类加载到内存中。
- 建立连接：使用驱动管理器（DriverManager）根据数据库URL、用户名和密码创建一个数据库连接对象（Connection）。
- 创建语句：通过连接对象创建一个语句对象（Statement或PreparedStatement）,用于执行SQL语句。
- 执行查询：使用语句对象执行SQL查询，并返回结果集对象（ResultSet）或更新计数。
- 处理结果：遍历结果集,提取并处理查询到的数据。
- 关闭资源：按顺序关闭结果集、语句和连接,释放数据库资源。
JSP连接数据库的详细步骤
下面，我们将以连接MySQL数据库为例,详细拆解在JSP页面中实现数据库连接的每一个环节。
第一步：准备工作
在编写代码之前,请确保以下环境已准备就绪：
- 数据库：已安装并运行MySQL数据库，并创建了相应的数据库和表，我们创建一个名为
test_db的数据库，其中包含一个users表。 - JDBC驱动：下载对应数据库版本的JDBC驱动JAR包（MySQL Connector/J）。
- Web服务器：如Apache Tomcat。
- 集成开发环境（IDE）：如Eclipse或IntelliJ IDEA。
最关键的一步是将下载的JDBC驱动JAR包（例如mysql-connector-j-x.x.x.jar）复制到Web应用的WEB-INF/lib目录下，这样，Web服务器在启动时才能将该驱动加载到应用的类路径（Classpath）中。
第二步：加载JDBC驱动
传统方式下，我们使用Class.forName()方法显式地加载驱动类，这行代码会触发驱动类的静态初始化块，从而将其注册到DriverManager中。
<%
try {
Class.forName("com.mysql.cj.jdbc.Driver");
} catch (ClassNotFoundException e) {
out.println("找不到MySQL驱动类！");
e.printStackTrace();
}
%>
值得注意的是，从JDBC 4.0开始，如果驱动JAR包在类路径下，并且其META-INF/services/java.sql.Driver文件配置正确，驱动可以被自动加载，Class.forName()不再是必需的，但为了代码的兼容性和明确性,保留此语句仍是一种良好实践。
第三步：建立数据库连接
使用DriverManager.getConnection()方法来获取一个Connection对象，该方法需要三个参数：数据库URL、用户名和密码。
数据库URL的格式遵循特定规范，对于MySQL,其格式如下：
| 组成部分 | 描述 | 示例 |
|---|---|---|
jdbc:mysql:// |
协议和子协议，固定部分 | jdbc:mysql:// |
hostname |
数据库服务器地址 | localhost 或 168.1.100 |
port |
数据库服务端口号 | 3306 |
/dbname |
要连接的数据库名称 | /test_db |
?parameters |
可选的连接参数，如时区、编码等 | ?useSSL=false&serverTimezone=UTC |
一个完整的连接示例代码如下：
<%
String url = "jdbc:mysql://localhost:3306/test_db?useSSL=false&serverTimezone=UTC&characterEncoding=utf8";
String username = "root";
String password = "your_password";
Connection conn = null;
try {
conn = DriverManager.getConnection(url, username, password);
out.println("数据库连接成功！");
} catch (SQLException e) {
out.println("数据库连接失败！");
e.printStackTrace();
}
%>
第四步至第六步：执行SQL并处理结果
成功建立连接后，就可以创建Statement对象来执行SQL了，为了防止SQL注入攻击，强烈推荐使用PreparedStatement。
以下是一个完整的示例，它查询users表中的所有数据并在页面上显示：
<%@ page import="java.sql.*, java.util.*" contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>JSP数据库连接示例</title>
<style>
table { width: 80%; margin: 20px auto; border-collapse: collapse; }
th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }
th { background-color: #f2f2f2; }
</style>
</head>
<body>
<h2 align="center">用户列表</h2>
<table>
<tr>
<th>ID</th>
<th>用户名</th>
<th>邮箱</th>
</tr>
<%
Connection conn = null;
PreparedStatement pstmt = null;
ResultSet rs = null;
String url = "jdbc:mysql://localhost:3306/test_db?useSSL=false&serverTimezone=UTC&characterEncoding=utf8";
String user = "root";
String password = "your_password";
try {
// 1. 加载驱动
Class.forName("com.mysql.cj.jdbc.Driver");
// 2. 建立连接
conn = DriverManager.getConnection(url, user, password);
// 3. 创建PreparedStatement
String sql = "SELECT id, username, email FROM users";
pstmt = conn.prepareStatement(sql);
// 4. 执行查询
rs = pstmt.executeQuery();
// 5. 处理结果集
while (rs.next()) {
int id = rs.getInt("id");
String username = rs.getString("username");
String email = rs.getString("email");
%>
<tr>
<td><%= id %></td>
<td><%= username %></td>
<td><%= email %></td>
</tr>
<%
}
} catch (Exception e) {
out.println("发生错误: " + e.getMessage());
e.printStackTrace();
} finally {
// 6. 关闭资源 (至关重要)
if (rs != null) try { rs.close(); } catch (SQLException e) {}
if (pstmt != null) try { pstmt.close(); } catch (SQLException e) {}
if (conn != null) try { conn.close(); } catch (SQLException e) {}
}
%>
</table>
</body>
</html>
第七步：关闭资源
在finally块中关闭ResultSet、Statement和Connection是绝对必要的，数据库连接是宝贵的资源，如果不及时释放，会导致连接泄漏，最终使应用因无可用连接而崩溃,关闭顺序应与创建顺序相反。
最佳实践与架构建议
虽然上述直接在JSP中编写数据库代码的方式对于学习和小型项目是可行的，但在实际的企业级开发中，这是一种非常糟糕的实践，它违反了MVC（Model-View-Controller）设计模式，导致代码难以维护、复用和测试。
推荐的架构是MVC模式：
- Model（模型）：由JavaBean（POJO）和DAO（Data Access Object）组成，负责封装数据和业务逻辑,以及所有的数据库操作。
- View（视图）：即JSP页面，仅负责数据的展示，不包含任何Java业务逻辑代码,它使用EL表达式和JSTL标签来渲染从Controller传递过来的数据。
- Controller（控制器）：通常由Servlet担任，负责接收客户端请求，调用Model处理业务逻辑,然后选择合适的View进行响应。
为了提升性能，应使用数据库连接池（如HikariCP、Druid、C3P0）来管理数据库连接,避免频繁地创建和销毁连接所带来的巨大开销。
相关问答FAQs
问题1：为什么我的JSP页面连接数据库时总是报 ClassNotFoundException: com.mysql.cj.jdbc.Driver 错误？
解答： 这个错误非常经典，它意味着Java虚拟机（JVM）在运行时无法找到MySQL的JDBC驱动类，根本原因在于驱动的JAR包没有被正确地添加到Web应用的类路径中,请检查以下两点：
- 确认JAR包位置：确保你已经将MySQL Connector/J的JAR文件（例如
mysql-connector-j-x.x.x.jar）复制到了你的Web项目下的WEB-INF/lib目录中。 - 重启服务器：在将JAR包放入
WEB-INF/lib目录后，必须重启你的Web服务器（如Tomcat），服务器才会重新加载应用的类库,从而识别到新加入的驱动。
问题2：在JSP中直接写数据库连接代码有什么弊端？
解答： 在JSP页面中直接嵌入数据库连接和操作代码（即所谓的“Scriptlet”）存在诸多严重弊端,是现代Web开发中极力避免的做法：
- 代码耦合度高，难以维护：将HTML展示逻辑、Java业务逻辑和数据库访问逻辑混杂在一起，一旦需求变更，修改起来会非常困难,牵一发而动全身。
- 可读性差：JSP页面中充斥着大量的Java代码，使得前端开发者难以理解和修改页面结构,而后端开发者也不方便维护业务逻辑。
- 代码复用性低：数据库连接和查询代码被写死在单个JSP中，无法在其他页面或模块中复用,导致大量冗余代码。
- 安全性风险：数据库连接信息（URL、用户名、密码）直接暴露在JSP源码中,增加了信息泄露的风险。
- 违反MVC设计原则：这种做法严重违反了关注点分离的原则，使得视图层（View）承担了模型层（Model）和控制器（Controller）的职责，不利于项目的团队协作和长期演进，正确的做法是采用MVC架构，将数据库操作封装在DAO层，由Servlet作为控制器进行调度,JSP只负责纯粹的数据展示。