JSP+Servlet学生信息管理系统实战：从CRUD到二次开发

简介这是一份面向Java Web初学者与课程实践者的学生信息管理系统完整项目源码以JSP与Servlet为核心技术栈配合MVC设计模式串联数据模型、页面展示与请求控制适合用于课程设计、毕业设计参考或Java Web入门练手。压缩包共576个文件约2.75MB包含156个html、132个css、105个png、79个js等前端资源20个java源文件与20个class编译文件对应Servlet与DAO实现另有9个jar依赖、1个sql初始化脚本及若干json、xml配置构成可直接部署到Tomcat运行的工程结构。已有999人学习下载。项目覆盖JDBC增删改查、HTTP请求响应流程、会话管理、表单验证与异常日志处理等环节读者可据此理解Servlet接收请求、调用DAO操作数据库、再由JSP渲染页面的完整链路并借助sql脚本快速搭建数据库环境是梳理Java Web开发流程的实用案例。1. 一个 JSP Servlet 学生信息管理系统为什么值得拿来练手接手一个“学生信息管理系统”的课程设计或外包小单最怕的不是功能多而是技术栈选错上来就 Spring Boot Vue环境配两天业务还没写一行。JSP Servlet 这套老组合反而适合这类场景——Tomcat 一装、JDBC 一配增删改查当天就能跑通。这个项目就是典型的 Java Web 原生实现Servlet 接请求、JSP 渲染页面、JDBC 操作数据库没有框架黑盒每一层都能看到。适合刚学完 Java Web 想找个完整项目练手的人也适合需要快速交付一个可运行 CRUD 系统的开发者。下面按“能干什么 → 怎么跑 → 怎么改”拆开讲。2. 技术栈与目录结构一个请求从浏览器到数据库的完整链路2.1 技术选型为什么是 Servlet JSP 而不是框架这个项目的技术栈很朴素Java Servlet 负责控制层JSP 负责视图层JDBC 直连数据库前端用原生 HTML/CSS/JavaScript 加少量 jQuery。没有 Spring、没有 MyBatis也没有 Maven 之外的构建工具。这种选型在今天的生产环境里确实少见但对学习和快速交付有实际价值。Servlet 的doGet/doPost是理解 HTTP 请求处理最直接的入口JSP 的 EL 表达式和 JSTL 标签能让你看清“数据怎么从后端塞进页面”。框架帮你屏蔽的细节在这里全是明面上的。常见做法是控制层每个业务模块一个 Servlet比如StudentServlet、CourseServlet、ScoreServlet视图层按模块分目录放 JSP数据访问层单独抽一个dao包里面用 JDBC 写 SQL。这样分层虽然原始但改起来定位快——页面问题看 JSP逻辑问题看 ServletSQL 问题看 DAO。依赖方面除了 Servlet API 和 JSP APITomcat 自带主要就是数据库驱动比如 MySQL 的mysql-connector-java。如果用了 JSTL 标签库还需要jstl.jar和standard.jar。这些 jar 包放在WEB-INF/lib下Tomcat 启动时自动加载。2.2 目录结构每个包放什么、每个 JSP 管哪块一个典型的目录结构长这样StudentMS/ ├── src/ │ └── com/ │ └── sms/ │ ├── controller/ # Servlet 控制层 │ │ ├── LoginServlet.java │ │ ├── StudentServlet.java │ │ └── ScoreServlet.java │ ├── dao/ # 数据访问层 │ │ ├── StudentDao.java │ │ └── ScoreDao.java │ ├── model/ # 实体类 │ │ ├── Student.java │ │ └── Score.java │ └── util/ # 工具类 │ └── DBUtil.java ├── WebContent/ │ ├── WEB-INF/ │ │ ├── lib/ # 第三方 jar │ │ └── web.xml # Servlet 映射配置 │ ├── css/ │ ├── js/ │ ├── login.jsp │ ├── student/ │ │ ├── list.jsp │ │ └── edit.jsp │ └── score/ │ └── list.jsp └── .classpath / .project # Eclipse 工程文件controller包里的 Servlet 负责接收参数、调用 DAO、转发或重定向到 JSP。dao包只做数据库操作返回ListStudent或单个对象。model包是纯 POJO字段和数据库表列一一对应。util包里的DBUtil管连接获取和关闭是整个项目最容易出问题也最该先看的地方。web.xml里配置 Servlet 的url-pattern比如/student/*映射到StudentServlet。如果用了注解WebServlet(/student)可以省掉这部分配置但老项目里web.xml更常见改的时候注意两处别冲突。2.3 请求链路从点击“查询”到页面出数据拿学生列表页举例完整链路是这样的浏览器访问/student?actionlistTomcat 根据web.xml或注解把请求交给StudentServlet。StudentServlet.doGet里读取action参数判断走哪个分支。调用StudentDao.findAll()DAO 里用 JDBC 执行SELECT * FROM student把结果集封装成ListStudent。Servlet 把 list 放进request.setAttribute(students, list)然后request.getRequestDispatcher(/student/list.jsp).forward(request, response)。list.jsp用 JSTL 的c:forEach遍历students渲染成表格行。这条链路里action参数是路由的关键。常见做法是在一个 Servlet 里用if (list.equals(action))这种分支处理多个操作而不是每个操作写一个 Servlet。好处是映射少、改起来集中坏处是单个 Servlet 会变长超过 300 行就该考虑拆了。3. 核心模块拆解登录、学生 CRUD 和分页各写了什么3.1 数据库连接工具类一个 DBUtil 管住所有连接DBUtil是整个项目的地基写不好后面全是连接泄漏。常见写法是静态代码块加载驱动getConnection()返回连接close()统一关闭public class DBUtil { private static final String URL jdbc:mysql://localhost:3306/student_ms?useSSLfalsecharacterEncodingutf8; private static final String USER root; private static final String PASSWORD 123456; static { try { Class.forName(com.mysql.cj.jdbc.Driver); } catch (ClassNotFoundException e) { throw new RuntimeException(数据库驱动加载失败, e); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } public static void close(Connection conn, PreparedStatement ps, ResultSet rs) { try { if (rs ! null) rs.close(); } catch (SQLException e) { e.printStackTrace(); } try { if (ps ! null) ps.close(); } catch (SQLException e) { e.printStackTrace(); } try { if (conn ! null) conn.close(); } catch (SQLException e) { e.printStackTrace(); } } }URL里的characterEncodingutf8不能省否则中文姓名入库变问号。useSSLfalse是本地开发常见配置避免启动时 SSL 警告。close方法按ResultSet → PreparedStatement → Connection的顺序关和打开顺序相反这是 JDBC 的基本规矩。注意这里每次getConnection()都新建连接没有连接池。小项目并发低能扛住但页面一多、请求一密集就会慢。改造时优先换成 Druid 或 HikariCPDBUtil的对外方法不用变只改内部实现这是最划算的优化点。3.2 学生列表 Servlet参数接收、DAO 调用和转发StudentServlet的doGet是入口核心分支如下protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding(UTF-8); response.setContentType(text/html;charsetUTF-8); String action request.getParameter(action); if (action null) action list; switch (action) { case list: listStudents(request, response); break; case delete: deleteStudent(request, response); break; case edit: showEdit(request, response); break; default: listStudents(request, response); } } private void listStudents(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String keyword request.getParameter(keyword); ListStudent students studentDao.findByKeyword(keyword); request.setAttribute(students, students); request.getRequestDispatcher(/student/list.jsp).forward(request, response); }request.setCharacterEncoding(UTF-8)必须放在读取任何参数之前否则 POST 中文乱码。action为空时默认走列表避免直接访问/student报错。listStudents里把查询结果放进 request 作用域用forward而不是redirect因为要带着数据跳转。deleteStudent分支通常先删再重定向回列表用response.sendRedirect(request.getContextPath() /student?actionlist)这样刷新页面不会重复删除。这是 CRUD 里最容易翻车的地方——用 forward 做删除后刷新会重复提交。3.3 学生 DAOPreparedStatement 防注入和结果集映射DAO 层负责把 SQL 和对象互转核心是两个方法public ListStudent findByKeyword(String keyword) { ListStudent list new ArrayList(); String sql SELECT id, name, gender, age, major FROM student; if (keyword ! null !keyword.trim().isEmpty()) { sql WHERE name LIKE ? OR major LIKE ?; } Connection conn null; PreparedStatement ps null; ResultSet rs null; try { conn DBUtil.getConnection(); ps conn.prepareStatement(sql); if (keyword ! null !keyword.trim().isEmpty()) { ps.setString(1, % keyword.trim() %); ps.setString(2, % keyword.trim() %); } rs ps.executeQuery(); while (rs.next()) { Student s new Student(); s.setId(rs.getInt(id)); s.setName(rs.getString(name)); s.setGender(rs.getString(gender)); s.setAge(rs.getInt(age)); s.setMajor(rs.getString(major)); list.add(s); } } catch (SQLException e) { e.printStackTrace(); } finally { DBUtil.close(conn, ps, rs); } return list; }SQL 拼接只拼条件结构值一律用?占位这是防 SQL 注入的底线。LIKE的通配符%拼在setString的参数里不能拼进 SQL 字符串。结果集映射按列名取值列名和实体字段对不上时getInt会抛异常所以建表时列名尽量和实体属性一致。finally里统一关资源即使查询抛异常也不会泄漏连接。如果后面要加分页这个方法的 SQL 要改成带LIMIT ?, ?同时补一个countByKeyword查总数。3.4 登录拦截Filter 比每个 Servlet 里写判断更省事登录校验如果写在每个 Servlet 开头重复且容易漏。常见做法是加一个LoginFilterWebFilter(/*) public class LoginFilter 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.jsp) || uri.contains(/login)) { chain.doFilter(req, resp); return; } Object user request.getSession().getAttribute(currentUser); if (user null) { response.sendRedirect(request.getContextPath() /login.jsp); return; } chain.doFilter(req, resp); } }放行登录页和登录请求其余一律检查 session 里的currentUser。没登录就重定向到登录页有登录就放行。WebFilter(/*)拦截所有路径注意静态资源css/js也会被拦实际项目里通常再加一个后缀判断放行。4. 跑起来环境准备、建库建表和启动验证4.1 环境清单和版本对齐跑这个项目需要JDK 8 或 11、Tomcat 8.5 或 9、MySQL 5.7 或 8.0、Eclipse 或 IntelliJ IDEA社区版够用。版本对齐很重要——Tomcat 10 把javax.servlet改成了jakarta.servlet老代码直接编译不过。如果手上只有 Tomcat 10要么换 Tomcat 9要么全局替换包名后者改动量大新手不建议。MySQL 8 的驱动类名是com.mysql.cj.jdbc.DriverMySQL 5 是com.mysql.jdbc.DriverDBUtil里写错会报ClassNotFoundException。驱动 jar 版本也要和数据库版本匹配8.0 的库用 5.x 的驱动连不上。4.2 建库建表三张表撑起整个系统最小可运行需要学生表完整一点加课程表和成绩表CREATE DATABASE student_ms DEFAULT CHARACTER SET utf8mb4; USE student_ms; CREATE TABLE student ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL, gender VARCHAR(4), age INT, major VARCHAR(100) ); CREATE TABLE course ( id INT PRIMARY KEY AUTO_INCREMENT, course_name VARCHAR(100), credit INT ); CREATE TABLE score ( id INT PRIMARY KEY AUTO_INCREMENT, student_id INT, course_id INT, score DECIMAL(5,2), FOREIGN KEY (student_id) REFERENCES student(id), FOREIGN KEY (course_id) REFERENCES course(id) );字符集用utf8mb4而不是utf8避免生僻字和特殊符号出问题。外键约束在练习项目里可以加方便理解关联查询如果导入数据时嫌麻烦可以先去掉外键导完再加。4.3 部署和启动war 包怎么进 TomcatEclipse 里导入项目后右键项目 → Properties → Project Facets确认 Dynamic Web Module 版本和 Tomcat 匹配。然后在 Servers 视图里新建 Tomcat 实例把项目 add 进去启动。如果不用 IDE手动打包jar -cvf StudentMS.war .在 WebContent 目录下执行把 war 丢进 Tomcat 的webapps启动后访问http://localhost:8080/StudentMS/login.jsp。启动后先验证三件事登录页能打开、用预置账号能进主页、学生列表能查出数据。三件事都过说明驱动、连接、映射、转发链路全通。任何一步失败先看 Tomcat 控制台异常栈再看DBUtil的 URL 和账号密码。提示第一次跑建议先在数据库里手动插两条学生记录避免列表页空白分不清是查询没写对还是本来就没数据。5. 避坑排查这几个问题我踩过不止一次5.1 中文乱码现象是姓名变问号原因是编码链没统一现象新增学生后列表里姓名显示???或者搜索中文搜不到。原因乱码可能出在三处——JSP 页面pageEncoding、Servlet 的request.setCharacterEncoding、数据库连接 URL 的characterEncoding。任何一处不是 UTF-8中文就会在那一环断掉。GET 请求的参数编码还受 Tomcat 的server.xml里Connector的URIEncoding影响。解决JSP 头部写% page contentTypetext/html;charsetUTF-8 pageEncodingUTF-8 %Servlet 第一行request.setCharacterEncoding(UTF-8)JDBC URL 加characterEncodingutf8Tomcat 8 以上默认 UTF-8一般不用改server.xml。四处对齐后重启问题基本消失。5.2 空指针现象是点删除报 500原因是参数没判空现象列表页点“删除”控制台抛NullPointerException页面 500。原因deleteStudent里直接Integer.parseInt(request.getParameter(id))如果 id 参数没传或传了空串parseInt就炸。常见于手改 URL 或前端按钮的 href 拼错。解决解析前先判空String idStr request.getParameter(id); if (idStr null || idStr.isEmpty()) { response.sendRedirect(...); return; }。所有从请求里取参数的地方都按这个模式处理别假设前端一定传对。5.3 连接泄漏现象是跑一会儿就卡死原因是没在 finally 关现象系统用一段时间后所有查询变慢甚至无响应重启 Tomcat 又好了。原因某个 DAO 方法在异常路径上没关连接连接数耗尽。MySQL 默认最大连接数 151泄漏几十次就撑不住。解决所有 JDBC 操作统一走try-finallyfinally里调DBUtil.close。排查时可以在getConnection里打印当前连接数或者直接看 MySQL 的show processlist一堆Sleep状态的连接就是证据。根治方案是换连接池池子会回收空闲连接。5.4 404 和 405现象是访问路径报错原因是映射和方法不匹配现象访问/student报 404或者表单提交报 405。原因404 通常是web.xml的url-pattern和实际访问路径不一致或者注解和web.xml同时配了导致冲突。405 是表单用 POST 提交但 Servlet 只重写了doGet没重写doPost。解决先看 Tomcat 启动日志里 Servlet 映射有没有注册成功web.xml和WebServlet二选一别混用。表单提交的 Servlet 补上doPost内部直接调doGetdoPost里先设编码再转发。6. 二次开发从单表 CRUD 到带权限的多模块系统拿到这个项目后最值钱的改造不是换框架而是在现有分层上把边界划清。我的习惯是先动DBUtil把直连换成连接池这一步对外零影响但收益最大// 用 HikariCP 替换 DriverManagerDBUtil 对外方法不变 private static final HikariDataSource DS; static { HikariConfig config new HikariConfig(); config.setJdbcUrl(URL); config.setUsername(USER); config.setPassword(PASSWORD); config.setMaximumPoolSize(10); DS new HikariDataSource(config); } public static Connection getConnection() throws SQLException { return DS.getConnection(); }maximumPoolSize按并发量调练习项目 10 够用。改完后 DAO 一行不用动这是分层带来的好处。第二个改造点是权限。现在只有“登录/未登录”两态加角色时在student表旁加user表字段username、password、role。LoginFilter里从 session 取角色按角色判断能访问哪些action。比如学生角色只能看自己的成绩管理员能改所有数据。判断逻辑集中在一个checkPermission(role, action)方法里别散落到各个 Servlet。第三个改造点是分页。列表页数据一多就卡DAO 加findByPage(keyword, offset, limit)Servlet 算offset (page - 1) * limitJSP 底部渲染页码。页码参数从请求取默认第 1 页越界时钳到合法范围。验证改造是否成功我一般走一遍固定清单登录 → 列表 → 搜索 → 新增 → 编辑 → 删除 → 退出每步看控制台有无异常、数据库数据是否一致。这套流程走顺了再谈加课程管理、成绩录入这些模块。有个教训值得说早期我改这类项目喜欢一次性重构所有 DAO结果一处 SQL 写错整个系统起不来排查半天。从那以后我每次只改一个模块改完立刻跑一遍上面的清单确认没问题再动下一个。希望帮到你。本文还有配套的精品资源点击获取