简介在Java Web开发领域课程设计经常要求学生完成一个可运行的管理系统。基于Servlet、JSP和JDBC的三层架构是理解Web请求处理流程的最佳实践。通过PreparedStatement预编译防SQL注入、Session实现登录拦截、Filter处理编码和权限控制能有效提升系统的安全性与规范性。这种架构广泛应用于学生信息管理、教务管理等场景也是毕业设计和简历中的常见项目。本文围绕学生信息管理系统的完整实现从环境配置、数据库设计、核心代码到常见踩坑点展开帮助开发者快速跑通项目并理解Java Web核心原理。1. 曾让无数学会变“毕业困难户”的题目如今成了最快能跑通的课程设计如果你正在刷“Java Web 课程设计”或“学生信息管理系统源码”这类关键词大概率是带着一个很具体的诉求想找一个能跑起来、能讲解、能交差的完整项目。这个标题下的 zip 包本质就是一个基于 Servlet JSP JDBC 的经典三层架构项目少数版本会套上 SSM 框架。我见过很多同学把时间耗在环境配置上最后连登录页面都打不开也见过用这个项目当脚手架两天就完成答辩的人。差别不在智商而在有没有把那几个关键的坑提前排掉。这篇笔记就顺着这个 zip 包讲清楚它是什么结构、哪些代码是核心、数据库怎么建、以及我自己的踩坑记录。这套系统适用的人群非常固定Java Web 期末课程设计、毕业设计任务书里点名要“B/S 架构学生信息管理”的题目以及想快速搞懂 Java Web 请求响应模型的初学者。它不是一个生产级系统但你把它完整跑通、改造成自己的设计再顺带讲讲 PreparedStatement 防 SQL 注入和 Session 做登录拦截答辩老师基本不会再刁难你。2. 从 zip 源码到浏览器能访问环境准备与项目结构梳理拿到这个 zip 包的第一件事不是双击解压而是先确认两件事它基于什么构建工具Maven 还是纯 Web 项目以及它的 Servlet API 版本。这决定了你在 IDEA 里是直接打开还是需要手动配 jar 包。2.1 先看目录别急着点绿色三角解压后你大概率会看到一个类似下面的结构这是最常见的 Java Web 课程设计布局StudentManager ├── src │ ├── com.example.dao # JDBC 数据访问层 │ ├── com.example.entity # 学生、用户等实体类 │ ├── com.example.servlet # 控制层 │ └── com.example.util # 数据库连接工具类 ├── web │ ├── WEB-INF │ │ └── web.xml # Servlet 映射与欢迎页 │ ├── css │ ├── js │ └── index.jsp # 登录页 └── sql └── studentdb.sql # 建库脚本抓重点sql目录下的建库脚本是整个项目的命脉没有它后面全是 500web.xml决定哪个 Servlet 拦截哪个路径util包里的 DBUtil 决定你能不能连上数据库。先打开这三个文件看一眼对环境心里有数。2.2 环境版本对照Tomcat 8.5 是默认安全区Tomcat 10 建议直接换项目这里有个血泪经验很多课程设计源码是在 Tomcat 8 时代写的用的是javax.servlet包。如果你图新装了 Tomcat 10 以上打开源码会看到The import javax.servlet cannot be resolved的红色错误。原因是 Tomcat 10 把包名迁到了jakarta.servlet老项目的包名全部失效。我一般做法是如果源码引的是javax就固定用 Tomcat 8.5 JDK 1.8如果源码引的是jakarta才考虑 Tomcat 11。IDEA 里部署的具体步骤是File - Project Structure - Artifacts点加号选 Web Application: Exploded然后配置 Tomcat Server - Local在 Deployment 标签页把刚才的 artifact 加进去Application context 填/或/student——这里我建议填student下面讲拦截器时会说明为什么。2.3 数据库连接串的三个玄学参数打开 DBUtil.java 或者你的jdbc.properties文件大概率能看到这样一段private static final String URL jdbc:mysql://localhost:3306/studentdb?useUnicodetruecharacterEncodingUTF-8serverTimezoneAsia/Shanghai; private static final String USER root; private static final String PASSWORD 123456;这段代码有三个必调的坑第一serverTimezoneAsia/Shanghai不写MySQL 8 大概率会报“The server time zone value Öйú±ê׼ʱ¼ä is unrecognized”的错字符集要在连接串显式声明否则 JSP 页面中文全是问号。第二MySQL 8 的驱动类名是com.mysql.cj.jdbc.Driver老源码里写com.mysql.jdbc.Driver的话在 MySQL 8 下也能跑但会刷警告。第三如果你用的 MySQL 是 8.0 以上密码加密方式默认是 caching_sha2_password老驱动不支持优先下载mysql-connector-java-8.0.x.jar放进web/WEB-INF/lib目录然后用上面那个 driver 类名。3. 把核心代码拆开来讲登录拦截、CRUD 与模糊搜索学生信息管理系统听起来功能很多但剥开看就三条主链路用户登录、学生信息的增删改查、按条件检索。剩下那些统计图表、课程管理、成绩导出都是在这三条链路上加包装。3.1 登录逻辑PreparedStatement 不是摆设是答辩安全加分项系统里几乎必然有一个LoginServlet拿着用户提交的 username 和 password 去数据库比对。很多课程设计源码直接用Statement字符串拼接一旦你用了拼接 SQL老师提问“你怎么防 SQL 注入”时就只能低头。标准写法是String sql SELECT * FROM user WHERE username ? AND password ?; PreparedStatement ps conn.prepareStatement(sql); ps.setString(1, username); ps.setString(2, password); ResultSet rs ps.executeQuery(); if (rs.next()) { HttpSession session request.getSession(); session.setAttribute(loginUser, rs.getString(username)); response.sendRedirect(student_list); } else { request.setAttribute(errorMsg, 用户名或密码错误); request.getRequestDispatcher(index.jsp).forward(request, response); }这里有两个要点一是PreparedStatement用?占位符传参数据库驱动会把参数转义从根上杜绝联合查询绕过二是登录成功后把用户信息塞进Session后续页面要判断“当前是否已登录”就看这个属性在不在。千万别用 Cookie 存用户名会暴露明文而且“Cookie 篡改登录”是答辩老师最爱的提问点。3.2 学生信息添加注意字符编码 Filter 的锅很多源码的乱码问题不在数据库而在表单提交那一层。如果web.xml里没有配置 CharacterEncodingFilterPOST 过来的中文就乱了一半。我习惯在项目中直接加入一个自定义编码过滤器WebFilter(/*) public class EncodingFilter implements Filter { public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { req.setCharacterEncoding(UTF-8); resp.setContentType(text/html;charsetUTF-8); chain.doFilter(req, resp); } }添加学生信息的 Servlet 里核心动作就是把表单字段读出来然后调用 DAO 层插入String studentId request.getParameter(studentId); String name request.getParameter(name); if (name null || name.trim().equals()) { response.getWriter().write(scriptalert(姓名不能为空);history.back();/script); return; } Student stu new Student(Integer.parseInt(studentId), name, ...); StudentDao dao new StudentDao(); int rows dao.addStudent(stu); if (rows 0) { response.sendRedirect(student_list?page1); }这个代码块里有三个关键点值得细看第一request.getParameter拿到的是 HTTP 原始参数如果是 null 说明表单里根本没传这个字段直接放行会触发 NullPointerException第二前端校验不顶用后端用name.trim().equals()挡空值这是答辩时的加分细节第三添加成功后用sendRedirect做重定向不用 forward避免用户按 F5 时重复提交同一条记录。3.3 分页 模糊查询组合起来就是系统的重头戏学生列表不会把几百行一次全查出来而是按页码取 10 条或 15 条。同时还要支持“输入学号或姓名模糊搜索”。这两块功能凑在一个查询里SQL 写法是SELECT * FROM student WHERE name LIKE ? OR student_id LIKE ? ORDER BY student_id LIMIT ?, ?;配合的 Java 代码大约长这样public ListStudent findByPage(String keyword, int page, int pageSize) { ListStudent list new ArrayList(); String sql SELECT * FROM student WHERE name LIKE ? OR student_id LIKE ? ORDER BY student_id LIMIT ?, ?; try (PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, % keyword.trim() %); ps.setString(2, % keyword.trim() %); ps.setInt(3, (page - 1) * pageSize); // 偏移量从 0 开始 ps.setInt(4, pageSize); try (ResultSet rs ps.executeQuery()) { while (rs.next()) { Student stu new Student(); stu.setId(rs.getInt(id)); stu.setStudentId(rs.getString(student_id)); stu.setName(rs.getString(name)); list.add(stu); } } } catch (SQLException e) { e.printStackTrace(); } return list; }参数说明(page - 1) * pageSize是 MySQL 分页的偏移量第 1 页就是 0第 2 页是 10模糊查询的%符号要放在setString的参数里写在 SQL 字面量里也有效但这更像拼接统一放参数更保险。另外关键字在查数据库之前先trim()去掉首尾空格不然用户在搜索框多敲一个空格就查不到结果这种问题相当隐蔽。4. 从零还原数据库与数据表sys_user、student 表上踩过的字段坑没有数据库脚本源码就是死代码。章节里我提供一张经过实际跑过、不做过度设计的建库结构你在自己的 MySQL 里直接能用。如果 zip 包里已经有studentdb.sql也可以对照下面的结构看看原作者的表设计。4.1 核心表结构用户表与学生表各需哪几个字段一般来说有两张表是必备的。第一张是系统用户表管登录CREATE TABLE sys_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(30) NOT NULL UNIQUE, password VARCHAR(32) NOT NULL, real_name VARCHAR(30) DEFAULT NULL, role VARCHAR(20) DEFAULT student COMMENT 角色标记, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;第二张是学生信息表承担主业务数据CREATE TABLE student ( id INT PRIMARY KEY AUTO_INCREMENT, student_id VARCHAR(20) NOT NULL UNIQUE COMMENT 学号, name VARCHAR(30) NOT NULL, gender CHAR(2) DEFAULT 男, birth_date DATE DEFAULT NULL, phone VARCHAR(20) DEFAULT NULL, email VARCHAR(50) DEFAULT NULL, major VARCHAR(50) DEFAULT NULL COMMENT 专业, class_name VARCHAR(30) DEFAULT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这里有几个用坑过的教训password字段在 MySQL 8 里不是保留字但避免用account、name这类容易撞查询的关键词总没错student_id虽然是学号但不要设为主键因为有的学校允许转学后学号重复自增id才是稳定主键student_id加 UNIQUE 约束保证业务唯一。字符集统一utf8mb4如果老源码的表是utf8插入生僻姓氏或 emoji 时直接报Incorrect string value这是老课程设计特别典型的问题。4.2 初始化数据别把管理员密码设成 root插入初始数据的时候管理员账号密码别再用 admin/123456 这种教科书配置至少改成一个存在感强一点的INSERT INTO sys_user (username, password, real_name, role) VALUES (admin, admin888, 系统管理员, admin), (teacher, teach123, 张老师, teacher);这里的 password 如果是存明文答辩时就说“这是课程设计为了演示方便做了简化实际生产会存 MD5 或 BCrypt 哈希”老师听得到。如果你胆子大一点也可以在代码里注册个MD5Util加盐存md5(password salt)这一步能直接让系统比市面上 70% 的课程设计高出一截。4.3 数据库版本兼容与导入顺序从 zip 里找到 sql 文件后在 Navicat 或命令行执行导入时注意顺序先建库再切库再建表最后插数据。如果你的studentdb.sql长这样CREATE DATABASE IF NOT EXISTS studentdb DEFAULT CHARACTER SET utf8mb4; USE studentdb; -- 建表语句...直接整份执行即可。如果脚本里没有CREATE DATABASE你就手动执行CREATE DATABASE studentdb;再切换到该数据库导入。执行完顺手跑一句SHOW TABLES;看到两张以上的表存在数据库这关就过了。5. 避坑指南课程设计源码跑不起来的 5 个高发原因标题里的 zip 包让很多人产生“解压即得”的幻觉实际把系统跑通平均会花掉两三个晚上。这一章把最常见的问题一次性陈列出来全是按现象 → 原因 → 解决的结构写的。5.1 现象浏览器访问 index.jsp 出现 404控制台显示 Servlet 映射找不到原因web.xml里 servlet 的url-pattern写的是/login但你访问路径写的是loginServlet或者路径少了一个斜杠。另一个常见情况是 IDEA 的项目 Artifact 名称带下划线导致访问根路径时不匹配。解决统一用WebServlet(/login)注解代替web.xml映射这是 Servlet 3.0 以上最不容易错的方式。如果用 XML 映射就仔细看servlet-mapping里的url-pattern必须包含/前缀servlet-mapping servlet-nameLoginServlet/servlet-name url-pattern/login/url-pattern /servlet-mapping5.2 现象登录时卡在“Loading…”然后报 500SQL 语句挂在 Unknown column xxx原因Java 实体类的属性名和数据库的列名对不上。比如实体类写的是stu_id表里列名是student_idPreparedStatement 执行SELECT name,stu_id FROM student时 MySQL 直接报字段不存在。解决把实体类字段与表结构对齐Java 侧用驼峰命名SQL 里写蛇形列名然后在 DAO 里做一次映射代码可读性也好。经验做法是打开Student.java和student表左右对照一行一个字段对着改别偷懒。5.3 现象项目启动了但列表页中文全是问号INSERT 进去的中文变 ??原因请求参数和响应的编码不一致。Tomcat 8 以上request.setCharacterEncoding只对 POST 生效GET 请求的参数编码由URIEncoding控制如果你的连接串里没有characterEncodingUTF-8数据库侧也会把中文写成问号。解决连接串加?useUnicodetruecharacterEncodingUTF-8同时 Filter 里设req.setCharacterEncoding(UTF-8)保证连接器、Servlet 容器、数据库三端编码一致。如果还乱检查数据库表是不是utf8mb4而不是gbk。5.4 现象驱动加载失败 ClassNotFoundException: com.mysql.jdbc.Driver原因这句话在 MySQL 8 下经常骗人。你实际用的是 MySQL 8驱动类名已改成了com.mysql.cj.jdbc.Driver而源码里写的是老名字也可能 jar 包没丢进WEB-INF/lib运行时根本加载不到。解决先确认mysql-connector-java-8.0.xx.jar是否在WEB-INF/lib下再检查驱动类名。如果项目是 Maven直接在 pom 里加dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.28/version /dependency5.5 现象明明改了 JSP 代码刷新浏览器跟改前一样原因这是典型的“Tomcat 热部署翻车”。IDEA 里 Artifact 输出目录没更新或者浏览器缓存里躺着旧页面。常见做法里有一个更隐蔽的JSP 文件改动后只按CtrlF10重新构建当前文件是不行的必须重新部署。解决IDEA 里点 Build - Rebuild Project把 target 目录删了重新 buildTomcat Server 配置里把 On Update Action 设为Redeploy并勾选Build before launch。再不行就去C:\Users\你的用户名\AppData\Local\JetBrains\IntelliJIdea2023.2\tomcat\下把临时目录清空会被清很多鬼问题。6. 把课程设计变成“有点东西”的系统验证清单与两个升级方向照上面流程把登录跑通、CRUD 点一遍这个 zip 包就消化得差不多了。这一章提供给那些答辩想拿高分、或者想把简历写充实一点的读者两个小而有效的改进方向。6.1 验证清单别等答辩才发现功能配不全系统手测时至少按下面这张表把它走一遍功能模块测试数据预期结果登录成功admin / 正确密码跳转列表页Session 已建立登录失败admin / 错误密码前端提示错误不产生 Session未登录访问列表直接访问 URL被拦截器重定向回登录页添加学生中文姓名 特殊字符页面正常显示数据库无乱码学号重复添加已存在的 student_id给出友善提示不抛 500搜索输入空字符串/带空格关键字返回全部数据不打转删除确认删除一条记录弹出确认框点确定才删这里最重要的一条是“未登录访问列表”。很多课程设计没做登录拦截意味着免登录直接输入路径就能进系统。用 Filter 实现拦截器其实就这么简单WebFilter(/*) public class AuthFilter implements Filter { public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request (HttpServletRequest) req; HttpServletResponse response (HttpServletResponse) resp; String uri request.getRequestURI(); if (uri.contains(login) || uri.endsWith(.js) || uri.endsWith(.css)) { chain.doFilter(req, resp); return; } HttpSession session request.getSession(false); if (session null || session.getAttribute(loginUser) null) { response.sendRedirect(index.jsp); return; } chain.doFilter(req, resp); } }这段代码的核心是两个分支静态资源和登录接口放行其余所有请求必须先检查 Session 里有没有loginUser没有就踢回登录页。request.getSession(false)里的传参很关键传 false 表示“没有 Session 就直接返回 null”如果是 getSession(true) 反而会强制创建一个新 Session绕过登录校验这个细节是面试和答辩的加分点。6.2 升级方向给 Servlet 包一层框架壳值不值得做如果你时间还有富余我最推荐的不是加功能而是给换个边说“我了解过主流框架”的身位。常见做法是把 JDBC 这层换成 MyBatis把 Servlet 换成 Spring MVC或者直接把项目改造成 Spring Boot。这里有一张对照表告诉你每一层代码迁移到哪里原结构改造目标说明DBUtilSpring Boot 的 DataSource 自动配置废弃手动注册驱动连接StudentDaoStudentMapper XMLSQL 拆分到 XML脱开 Java 代码StudentServletStudentControllerRestController RequestMappingJSP 页面Thymeleaf 模板 或 Vue Element UI前后端分离入门代价偏大web.xml无Spring Boot 内嵌容器自动处理这个改造并不需要推倒重来把StudentDao里每个方法对应出一条 MyBatis XML 配置Servlet 层改成 Controller本质上还是那几条 SQL。如果你只是想让答辩展示更亮眼把 Spring Boot 版本跑通就足够讲 15 分钟了但别在答辩前夜才动手。老话说得好课程设计这东西前期材料再乱不如先把一条链路完整跑通。我自己的习惯是拿到任何源码先配数据库、再跑登录、再改界面颜色一步一步来最后系统看着就像自己写的那样了。希望这篇笔记能把你的项目从“解压后吃灰”变成“明天就能演示”的状态帮到你。本文还有配套的精品资源点击获取