JSP课程设计实战：JavaBean与双数据库登录系统部署避坑全指南

简介：这是一份面向JSP初学者的课程设计小项目——留言本系统，采用JSP+JavaBean+Access组合开发，适合正在完成Web课程设计或想快速上手JSP开发流程的学生。系统无需配置数据源，放入Tomcat即可运行，并实现了UBB代码解析、UBB头像、正则表达式过滤、管理登录验证码以及MD5加密管理密码等功能，完整展示了JSP基础应用的常见写法。压缩包共194个文件，约621KB，其中157个gif主要作为表情与头像资源，13个jsp为页面主体，还包含5个class、5个css、4个db、4个js及1个mdb数据库文件；目录按页面、样式、类文件和数据库归置，便于快速定位。已有158人学习下载。通过这份资源可以拿到完整可跑的留言本项目，既能参考JavaBean封装数据库操作、JSP页面与样式分离的组织方式，也能学习验证码、MD5加密、正则替换等实用技巧，适合用于课程设计参考和入门练习。

1. 把JSP课程设计资源真正跑起来：JavaBean+Access/SQL双数据库登录实战

期末课程设计摊在面前，JSP登录系统作为经典题目，简单却五脏俱全：JavaBean、数据库操作、前台页面、会话管理全占了。如果你手里拿到一份jspbook.rar，里面是带JavaBean封装、Access与SQL Server双数据库支持的课程设计源码，那这篇笔记要帮你解决的是：怎么让它在你的笔记本上半个小时内跑起来，并且每一口坑都能说清楚原因。适合正在被课程设计追着跑的学生，也适合想快速复盘传统JSP项目结构的初学者。这份资源的最大价值不是代码本身，而是把一个可演示的登录系统从源码到数据库再到部署的路径完整串了起来，跑通它，JSP里最经典的几件事你就都见过了。

2. 导入与部署：先把这套JSP项目在本地跑通并看清目录结构

2.1 版本选型：JDK、Tomcat与IDE怎么配才不会踩老项目的雷

传统JSP课程设计项目大多是2015到2018年生成的，代码里全是javax.servlet，JavaBean也是老写法。给它配环境，第一原则是「不要用最新版」。我一般固定三个版本：JDK 8、Tomcat 8.5或9.0、IDEA 2021以上的版本都能兼容。JDK 8对老编译参数兼容性好，Tomcat 8.5/9还在javax包时代，正好匹配项目代码。你要是用Tomcat 10或11，启动时ClassNotFoundException找javax.servlet会让你怀疑人生，这个后面第5章细说。

IDE选择上，IDEA Ultimate自带Java Enterprise支持，Community版也能跑传统Web项目，手动配置Tomcat就行。学校机房如果还在用MyEclipse，导入逻辑也差不多，只是WebRoot识别方式略有差异。还有一点：项目路径不要出现中文和空格。很多老项目在别人的机器上能跑，到你这儿就乱码、404、失败，仔细一查全是路径问题。这一条放在版本选型里一并解决最划算。

2.2 资源包结构：rar里到底装了些什么

拿到jspbook.rar，先不要急着解压到桌面就双击跑。花两分钟看一眼目录结构，能省掉后面大量无用功。常见的课程设计资源包基本长这样：

打开资源包先确认三件事：WEB-INF/lib里有没有UCanAccess的jar，决定你后面用哪种Access驱动；db目录里给的是accdb文件还是mdb文件，以及有没有对应的SQL建库脚本；WebRoot下有没有web.xml。这三件事直接决定你能不能跑起来，以及数据库环节要不要额外处理。如果这个资源包给的是纯SQL Server版，那db目录里一般只有一个.sql文件，没有Access物理库，驱动和连接方式差得比较远，第3章会分别给代码。

还有个小细节：资源包里如果同时出现Access和SQL两个版本的脚本，先跑Access版。它不用额外装数据库服务，SQL Server版还得先在本机把MSSQL服务装好、建库、导数据，链路更长。把容易出错的环节后置，能明显提升第一遍跑通的概率。

2.3 从RAR到运行：IDEA导入与手动配置Tomcat的完整步骤

下面以IDEA Community版为例，把导入到运行的步骤完整走一遍。第一步是解压到一个全英文路径，比如D:\jspbook。

# 解压到英文路径，避免中文目录导致编译期和运行期双重乱码 mkdir D:\jspbook # 把 jspbook.rar 内容解压到 D:\jspbook 下 # 用 7-Zip 或 WinRAR 均可，解压后确认 src 和 WebRoot 在同一个根目录下

第二步，IDEA新建一个空Project，把解压出来的src目录和WebRoot目录直接拖进Project面板。IDEA会弹提示是否把src标记为Sources Root，选确认；如果识别出Web资源目录，也会问是否加到Web Facet里，同样确认。第三步是关键，Community版不会自动识别传统Web项目的根目录，必须手动指定。

File -> Project Structure -> Facets -> 添加 Web Web Resource Directory: 选择 WebRoot 目录 Deployment Descriptors: WebRoot/WEB-INF/web.xml

这里很多人漏掉第三步就急着重启Tomcat，结果页面全部404，原因就是Tomcat部署包里根本没把WebRoot下的JSP打进去。第四步配置Tomcat：Run菜单 -> Edit Configurations -> 左上角加号 -> Tomcat Server -> Local。打开Deployment标签，点加号选Artifact把项目加进去，Application context填 /jspbook。第五步启动，浏览器访问http://localhost:8080/jspbook/index.jsp，看到登录页就是通了。

整个过程中最容易出问题的就是第三步和第五步的路径一致性。Artifact里Output Layout要把WebRoot下的全部资源包含进去，否则本地Tomcat能启动、页面却找不到。我一般还会顺手看一眼Tomcat启动日志里有没有Deployment failed提示，比盯着浏览器看404靠谱。老项目在IDEA里第一次跑起来，靠的就是这几个目录指向不出错。

3. JavaBean与数据库连接层：Access和SQL Server两套驱动的切换方案

3.1 课程设计里为什么选JavaBean：评分点与可维护性

课程设计答辩时老师最常看的点：三层有没有分离、数据库有没有封装、页面里有没有散落SQL代码。JavaBean恰好把「业务逻辑」从页面里抽出来。这个资源包里，JavaBean负责两件事：拿数据库连接、做登录校验。JSP页面只用<jsp:useBean>调用，页面里看不到一行SQL，这是传统JSP项目最标准的写法，也是答辩时能随口讲清楚的设计点。

很多新手刚拿到源码时第一反应是找「主函数」，但Web项目里不存在这种东西。你要先找到bean包里的类，再顺着JSP页面的useBean标签找到调用入口。这个资源包如果结构规整，核心就两个Bean：DBConnection负责递数据库连接，LoginBean负责判断账号密码。先把结构在脑子里立起来，后面看代码就不乱。

3.2 DBConnection：Access连接与UCanAccess替代ODBC

老版课程设计资源里，Access连接通常走JDBC-ODBC桥再加ODBC数据源，典型代码长这样：

// 老写法，JDK 8以后不推荐 Class.forName("sun.jdbc.odbc.JdbcOdbcDriver"); String url = "jdbc:odbc:userdb";

这段代码当年能用，现在基本跑不通。原因不复杂：JDK 8里这个桥还能将就用，JDK 9直接移除了类；加上Windows 10/11 64位系统的ODBC数据源管理，32位和64位入口很容易配错。所以我默认把连接层换成UCanAccess，改动只有连接驱动和URL两处。

package bean; import java.sql.Connection; import java.sql.DriverManager; import java.sql.SQLException; /** * 数据库连接类：UCanAccess 纯Java驱动，不依赖ODBC */ public class DBConnection { private static final String DRIVER = "net.ucanaccess.jdbc.UcanaccessDriver"; private static final String URL = "jdbc:ucanaccess://D:/jspbook/db/userdb.accdb"; private static final String USER = ""; private static final String PASSWORD = ""; static { try { Class.forName(DRIVER); } catch (ClassNotFoundException e) { e.printStackTrace(); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } }

逻辑说明：驱动类名net.ucanaccess.jdbc.UcanaccessDriver是核心，URL前缀jdbc:ucanaccess://后跟Access文件的绝对路径。Access库一般没有用户名密码，USER和PASSWORD留空字符串。Class.forName在静态块里执行，类第一次加载时完成驱动注册，这个顺序在Java里是标准做法。

参数说明：UCanAccess 5.x要求JDK 8以上，依赖jackcess、commons-lang3、hsqldb、commons-io这几个jar，必须一起放进WEB-INF/lib，只放一个主jar照样报ClassNotFound。数据库文件路径用正斜杠或双反斜杠都行，但路径里不要带中文。如果资源包给的是.mdb老格式，UCanAccess同样支持，代码不用改。

如果资源包里恰好是SQL Server版，驱动和URL换成另一套，其余代码结构一模一样：

// SQL Server 连接参数 Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver"); String url = "jdbc:sqlserver://localhost:1433;DatabaseName=jspbook"; String user = "sa"; String password = "123456";

逻辑说明：SQL Server是服务型数据库，URL指向服务地址和端口，不是文件路径。1433是默认端口，DatabaseName对应你手动创建的业务库名。这里有个常见误导：sa密码填错会报login failed，但服务本身已经连上了，报错信息里带的是SQL Server的登录错误码，跟Access那类驱动错误完全不是一回事。

参数说明：SQL Server安装时可以选Windows身份验证或混合模式，默认Windows身份验证模式下，sa账号处于停用状态，需要先在SSMS里把服务器身份验证改为混合模式、启用sa账号并设好密码，再改这里的连接串。资源包里的SQL脚本一般是建库和建表语句，在SSMS里执行一遍就能把表结构建好。

3.3 用配置文件解耦双数据库：一套代码切换Access和SQL Server

这个资源包的卖点是双数据库支持，我在连接层会再加一个配置开关，让一套代码能跑两种库。做法是加一个db.properties放classpath根目录：

# db.properties，放到 src 根目录 db.type=access access.driver=net.ucanaccess.jdbc.UcanaccessDriver access.url=jdbc:ucanaccess://D:/jspbook/db/userdb.accdb access.user= access.password= sql.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver sql.url=jdbc:sqlserver://localhost:1433;DatabaseName=jspbook sql.user=sa sql.password=123456

配套的DBConnection改成读配置文件：

package bean; import java.io.InputStream; import java.sql.Connection; import java.sql.DriverManager; import java.sql.SQLException; import java.util.Properties; public class DBConnection { private static String driver; private static String url; private static String user; private static String password; static { try (InputStream in = DBConnection.class.getClassLoader() .getResourceAsStream("db.properties")) { Properties p = new Properties(); p.load(in); // db.type 是总开关：填 access 走 Access，填 sql 走 SQL Server if ("access".equals(p.getProperty("db.type"))) { driver = p.getProperty("access.driver"); url = p.getProperty("access.url"); user = p.getProperty("access.user"); password = p.getProperty("access.password"); } else { driver = p.getProperty("sql.driver"); url = p.getProperty("sql.url"); user = p.getProperty("sql.user"); password = p.getProperty("sql.password"); } Class.forName(driver); } catch (Exception e) { e.printStackTrace(); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(url, user, password); } }

逻辑说明：getResourceAsStream("db.properties")从classpath根目录读配置，不依赖具体磁盘路径。改库时只改db.type和对应前缀参数，Java代码一行不动。这个设计放课程设计文档的「系统设计」章节里讲，比直接贴原生连接代码得分高。

参数说明：try-with-resources会自动关闭InputStream，老项目里经常能看到忘记关流的写法，自己写的时候别学。Properties读出来的值全是字符串，db.type比较用equals，配置文件里不要带多余空格。SQL Server的URL里分号在properties文件里不需要转义，直接写就行。

4. 登录模块完整实现：从表单校验到Session管理到SQL注入边界

4.1 登录页面：前端校验与后端校验的分工

登录页是课程设计的第一张脸，页面要做到两件事：版式干净、校验双保险。前端用JavaScript做快速提醒，后端在JavaBean里做最终校验。前端校验可以被绕过，这层防的是手误，后端校验才是真正的安全边界，这个分工在答辩时几乎必问。

<%@ page contentType="text/html;charset=UTF-8" language="java" %> <html> <head><title>用户登录</title></head> <body> <div style="width:360px; margin:80px auto;"> <h3>用户登录</h3> <form action="doLogin.jsp" method="post" onsubmit="return checkForm()"> 用户名：<input type="text" name="username" id="username" required/> 密 码：<input type="password" name="password" id="password" required/> <button type="submit">登 录</button> </form> <% if (request.getAttribute("errorMsg") != null) { %> <p style="color:red;"><%= request.getAttribute("errorMsg") %></p> <% } %> </div> <script> function checkForm() { var u = document.getElementById("username").value.trim(); var p = document.getElementById("password").value.trim(); if (u === "" || p === "") { alert("用户名和密码不能为空"); return false; } return true; } </script> </body> </html>

逻辑说明：onsubmit返回false时表单不提交。错误提示用request.getAttribute("errorMsg")回显，登录失败时用户能看到具体原因而不是直接跳到空白页。这里注意一个细节：表单字段的name必须和JavaBean属性名一致，因为后面要靠<jsp:setProperty property="*">自动装配，写成name="user"而Bean属性是username就会装配不上。

参数说明：method="post"是硬性要求，登录请求不能用GET，否则密码会明文出现在地址栏。required是HTML5原生非空校验，checkForm()里再补一次trim空判断，两层前端校验叠加。页面编码用UTF-8，与后面乱码排查那章配合着看。

4.2 LoginBean：PreparedStatement怎么写才算真正防住了SQL注入

登录逻辑最忌讳字符串拼接SQL。一句' OR '1'='1就可以绕过密码直接登录，这个现象在Access和SQL Server上同样成立。课程设计里用PreparedStatement是标配，代码里也容易讲清楚。

// 不安全写法，反面教材 String unsafeSql = "SELECT COUNT(*) FROM users WHERE username='" + username + "' AND password='" + password + "'"; // 安全写法：PreparedStatement 参数化查询 public boolean checkLogin() { String sql = "SELECT COUNT(*) FROM users WHERE username=? AND password=?"; try (Connection conn = DBConnection.getConnection(); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setString(1, username); ps.setString(2, password); ResultSet rs = ps.executeQuery(); if (rs.next() && rs.getInt(1) > 0) { return true; } rs.close(); } catch (Exception e) { e.printStackTrace(); } return false; }

逻辑说明：?占位符让PreparedStatement把用户输入当字面量，不参与SQL结构解析。传入' OR '1'='1时，它只是一段普通字符串，不会成为查询条件的一部分。COUNT(*)用rs.getInt(1)取值，大于0说明账号密码匹配，这个写法比查出所有字段再遍历判断更轻。

参数说明：setString(1, username)里的下标从1开始，不是0。如果查询条件增加一个状态字段，就在SQL里再写一个?，再按顺序set一次。username和password在Bean的setter里最好先trim()再存，去掉首尾空格，能省掉一批「我明明输入对了」的排查时间。try-with-resources保证Connection和PreparedStatement自动关闭，这条对Access尤其重要，第5章会展开。

4.3 登录处理页与Session：登录态的建立、保持和销毁

传统JSP登录处理一般在doLogin.jsp里完成，它负责调用Bean、判断结果、跳转。理解这个页面的生命周期，整个登录模块就通了。

<%@ page contentType="text/html;charset=UTF-8" language="java" %> <jsp:useBean id="loginBean" class="bean.LoginBean" scope="page"/> <jsp:setProperty name="loginBean" property="*"/> <% if (loginBean.checkLogin()) { // 登录成功，写入 session session.setAttribute("loginUser", loginBean.getUsername()); response.sendRedirect("welcome.jsp"); } else { // 登录失败，回登录页并带错误提示 request.setAttribute("errorMsg", "用户名或密码错误"); request.getRequestDispatcher("login.jsp").forward(request, response); } %>

逻辑说明：scope="page"表示这个Bean只在这个页面实例里存活，用完即释放，课程设计场景下足够。property="*"自动从request请求参数里按属性名匹配填充，这就是4.1强调字段名必须一致的原因。session里存了loginUser后，后续页面靠它识别登录状态。forward是服务器内部跳转，地址栏不变，request里带的值还能用；sendRedirect是浏览器重定向，地址栏变化，request里的值全丢，所以错误提示必须塞进request再forward。

受保护页面顶部的守卫代码就三行：

<% Object user = session.getAttribute("loginUser"); if (user == null) { response.sendRedirect("login.jsp"); return; } %>

逻辑说明：session里的loginUser不存在就重定向回登录页，return必须写，否则页面下方代码会继续执行，守卫就失效了。登出操作一行session.invalidate()可以完成，但不要放在普通链接的href里用GET触发，那样会被浏览器预加载误触发，应该单独放一个logout.jsp处理。这套逻辑在答辩时按「登录态建立、保持、销毁」三个词讲，清晰且加分。

5. 避坑：JSP课程设计最常见的五个运行问题与排查记录

5.1 ODBC数据源报错：64位系统下Access驱动翻车

现象：项目正常启动，登录页也能打开，一点提交按钮Tomcat控制台报java.sql.SQLException: [Microsoft][ODBC 驱动程序管理器] 未发现数据源名称并且未指定默认驱动程序。

原因：老资源包用的是JDBC-ODBC桥加手工配置的ODBC数据源。JDK 8里这个桥还能用但不推荐，JDK 9直接删掉了sun.jdbc.odbc.JdbcOdbcDriver这个类。再加上Windows 10/11 64位系统下，ODBC数据源管理工具有32位和64位两个版本，控制面板进错入口就配到了另一个版本里，程序根本读不到。

解决：放弃ODBC，换UCanAccess纯Java驱动。把ucanaccess主jar和jackcess、commons-lang3、hsqldb、commons-io几个依赖jar放进WEB-INF/lib，驱动类和URL按第3章的方式改。数据库文件路径用绝对路径，并且保证全英文。改完记得清缓存重启Tomcat，这个坑我见过有人改了代码忘了重启，卡了半天。

5.2 中文乱码：JSP页面、请求、数据库三层编码对不齐

现象：用户名输入中文，登录后welcome.jsp页面上显示一串??，或者欢迎语变成乱码，刷新几次后有时正常有时乱。

原因：传统JSP项目三个环节都在影响字符集：JSP页面本身的pageEncoding、Tomcat接收请求时的解码方式、数据库表字段的字符集。老项目常把pageEncoding设为GBK，而后台按UTF-8解码，两边一碰撞就乱。

解决：统一UTF-8三步走。第一步，所有JSP页面头部加<%@ page contentType="text/html;charset=UTF-8" %>。第二步，在web.xml里配置Tomcat内置的SetCharacterEncodingFilter，把encoding参数设为UTF-8并映射到所有路径，这比在代码里手动request.setCharacterEncoding更可靠，因为过滤器在Servlet处理前就完成了编码统一。第三步，SQL Server版连接URL加;encoding=utf-8，Access版则确认Windows控制面板里「非Unicode程序的语言」设置的是简体中文。三步做完还乱码，就逐页检查是否某个页面漏了pageEncoding。

5.3 Access数据库文件被锁：多连接同时操作导致无法访问

现象：连续登录几次后，Tomcat控制台报另一个程序正在使用此文件，进程无法访问，数据库突然打不开，重启Tomcat以后又能坚持一阵子。

原因：Access是文件型数据库，不是服务型数据库，写操作是独占锁。课程设计代码里如果每个请求都新建连接，用完不关，多个连接同时碰同一个.accdb文件就会触发锁。这和并发量无关，哪怕两个请求同时写也会出问题。

解决：第一，所有获取Connection的地方必须关闭，直接在代码里用try-with-resources，让Connection、Statement、ResultSet自动关。第二，课程设计场景别做连接池，连接用完即关，连接池反而会让文件长时间被占。第三，检查有没有后台定时任务在持续打开数据库。最终防线是换成SQL Server，那是答辩级优化，先按前两条排查基本能解决。

5.4 Tomcat 10启动报ClassNotFound：javax和jakarta的版本鸿沟

现象：用Tomcat 10或11部署老项目，启动时控制台报ClassNotFoundException: javax.servlet.http.HttpServlet，页面全部打不开。

原因：Servlet规范从5.0开始改命名空间，把所有javax.*包迁移到jakarta.*。老课程设计项目全是javax开头，Tomcat 10的类加载器里不再提供javax包，所以直接找不到类。这不是资源包的锅，是环境版本不匹配。

解决：老项目用Tomcat 8.5或9.0。IDEA里新建Tomcat Server时版本选9，部署同一个Artifact，问题立刻消失。如果手里只有Tomcat 10，把代码里所有import javax.servlet改成import jakarta.servlet也能解决，但改完后有些第三方库内部引用的还是javax，不一定会完全消停，所以换Tomcat版本是更稳的路径。

5.5 启动后404：Web根目录没被IDE认出来

现象：Tomcat正常启动，控制台也没有报错，但浏览器访问http://localhost:8080/jspbook/index.jsp返回404。

原因：IDEA Community版不会自动识别传统Web项目的WebRoot目录。Facets配置里Web资源目录指错了位置，Artifact打包时没有把WebRoot下的JSP文件包含进去，部署到Tomcat的包里就只有class文件没有页面。

解决：打开Project Structure，Facets标签里选中Web，把Web Resource Directory指向WebRoot目录，Deployment Descriptors指向WebRoot/WEB-INF/web.xml；再打开Artifacts，确认Output Layout里WebRoot下的资源在部署包内。改完重新build再启动，然后到Tomcat的webapps目录看解压出来的文件夹里有没有JSP文件。这个坑在MyEclipse导出的老项目上尤其常见，因为MyEclipse默认WebRoot，IDEA默认webapp，两个根目录名不一样。

6. 打包与验收：把课程设计升级成可部署的WAR并扩充加分功能

6.1 WAR打包三步走

传统JSP项目的交付物是war文件，拷到Tomcat的webapps目录就能自动部署，不用开IDE。IDEA里打包路径是：File -> Project Structure -> Artifacts -> 加号选Web Application Archive，然后Build菜单里Build Artifacts执行构建，war生成在out目录。把它复制到Tomcat的webapps目录，重启Tomcat自动解压，访问http://localhost:8080/jspbook/就是完整项目。

这里有个几乎必踩的坑：war包里WEB-INF/lib下的驱动jar是否齐全。本地能跑是IDEA运行配置自动把lib带进classpath，打war时如果Artifacts的Output Layout里没把lib加进去，换台机器就报ClassNotFound。打包前手动看一眼war里WEB-INF/lib有没有驱动jar，比现场救火强。

6.2 三个改动不大但答辩加分的增强点

第一，密码MD5加密存储，注册时用MessageDigest把明文转MD5写库，登录时比对MD5值，数据库里不再存明文。第二，登录页加四字符验证码，用Graphics2D画带干扰线的图片，字符串存session提交时比对，验证码刷新和失效都能讲两句。第三，把登录失败次数记进数据库，连续三次锁账号十分钟。注意Access对并发写不友好，这个功能建议放在SQL Server版本上实现。

去年我带学弟调这个项目，Access驱动和中文乱码两个坑几乎每台机器都要踩一遍，后来养成了一个习惯：任何老课程设计项目到手，先确认数据库驱动和Tomcat版本，再动任何源码。你手里这份jspbook.rar要是还没跑通，按这个顺序来一遍，很大概率能少熬两晚上。希望帮到你。

本文还有配套的精品资源，点击获取