JavaWeb学生管理系统毕设实战：从环境搭建到增删改查完整指南

简介这是一套面向计算机相关专业毕设学生与Java项目实战练习者的学生管理系统完整资料基于JavaWeb技术栈实现可作为毕业设计或课程设计参考。系统采用Servlet、JSP、JDBC与DbUtils搭建后台前端使用EasyUI、jQuery与Ajax数据库为MySQL涵盖学生、教师、管理员三种角色学生可管理个人信息、查询成绩与通讯录教师可登记、统计并导出成绩管理员负责基础信息、考试与后台管理。资源包共15个文件约13.49MB包含项目源码压缩包、数据库脚本、项目文档PDF与Markdown、运行截图及软件工具下载说明结构清晰便于快速部署与二次开发。目前已有18530人学习下载项目经过严格调试界面美观、操作简单适合需要完整可运行源码与配套文档的Java学习者参考使用。1. 从一份“能跑起来”的 JavaWeb 学生管理系统说起如果你正在搜“基于JavaWeb实现的学生管理系统【附源码】毕设”大概率不是想听 MVC 概念而是想找一份能在本地跑通、能改、能写进毕设正文的完整案例。我带过几届学生的课程设计也帮人排查过不少“导入 IDEA 就报 500”的现场最常见的翻车不是代码写错而是环境没对齐JDK 版本、Tomcat 版本、MySQL 驱动、数据库字符集任意一个不对项目就起不来。这篇笔记按“先立住结构再动手复现最后讲坑”的顺序写目标很明确给你一套 JavaWeb 学生管理系统的落地路径包含数据库设计、Servlet/JSP 分层、增删改查实现、分页与登录拦截以及毕设里真正会被追问的参数和边界。适合两类人新手照着步骤能跑通熟手能直接看到哪些地方该换成 Spring Boot、哪些地方必须保留原生 Servlet 才符合“JavaWeb”选题要求。2. 学生管理系统到底该有哪些模块先定边界再写代码2.1 从毕设答辩角度反推功能清单很多人一上来就写代码写到一半发现“成绩管理”和“选课管理”边界不清最后数据库表互相打架。我的习惯是先画一张功能边界表把“必须有”和“可以砍”分开。学生管理系统在 JavaWeb 毕设里通常被拆成四块学生信息管理、班级管理、课程管理、成绩管理。如果标题里带“选课”那课程和成绩之间还要加一张选课关系表。下面这张表是我一般会先定下来的模块边界你可以直接照着改。模块核心表必做功能可裁剪功能学生信息student增删改查、分页、按姓名/学号搜索批量导入 Excel班级管理classes增删改查、班级人数统计班主任关联课程管理course增删改查、授课教师字段课程分类成绩管理score录入、修改、按学生/课程查询成绩分布图表用户登录user登录、注销、Session 拦截注册、找回密码这张表的作用不是给你抄而是让你在写实体类之前就知道外键怎么连。student 表里放 class_idscore 表里同时放 student_id 和 course_id这是最稳的三表关系。很多同学把班级名直接冗余进 student 表后期改班级名就要批量更新答辩时被问“数据一致性怎么保证”就答不上来。2.2 数据库建表字符集和主键类型是最容易埋雷的地方建表语句我一般直接写成一份 init.sql导入就能用。下面这段是核心三张表注意 utf8mb4 和 InnoDB 是必须的主键用 bigint 自增不要用学号当主键——学号会变主键不该变。-- 学生表class_id 外键指向班级 CREATE TABLE student ( id BIGINT PRIMARY KEY AUTO_INCREMENT, sno VARCHAR(20) NOT NULL UNIQUE COMMENT 学号, name VARCHAR(50) NOT NULL, gender TINYINT DEFAULT 1 COMMENT 1男 2女, class_id BIGINT, phone VARCHAR(20), create_time DATETIME DEFAULT CURRENT_TIMESTAMP, KEY idx_class (class_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 课程表 CREATE TABLE course ( id BIGINT PRIMARY KEY AUTO_INCREMENT, cname VARCHAR(100) NOT NULL, credit DECIMAL(3,1) DEFAULT 2.0, teacher VARCHAR(50) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 成绩表student_id course_id 联合唯一防止重复录入 CREATE TABLE score ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_id BIGINT NOT NULL, course_id BIGINT NOT NULL, score DECIMAL(5,1), UNIQUE KEY uk_stu_course (student_id, course_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;逻辑说明student 表的 sno 加了唯一索引防止重复学号score 表用联合唯一键这是成绩录入最容易出的问题——同一个学生同一门课被录两次查询时出现两条记录。参数上score 用 DECIMAL(5,1) 而不是 float因为成绩要精确到 0.5 分float 会出现 89.99999 这种玄学值。字符集必须 utf8mb4否则学生姓名里的生僻字会变成问号这个坑我在答辩现场见过不止一次。2.3 分层结构Servlet Service DAO 怎么切才不返工JavaWeb 项目最怕把所有逻辑塞进一个 Servlet。我一般按 entity、dao、service、servlet、util 五层来分包名用 com.xxx.student。entity 放实体类dao 只做 SQLservice 做业务判断servlet 只负责收参数和转发。这样切的好处是答辩时老师问“业务逻辑在哪”你能直接指到 service 层后期想换 Spring Bootdao 和 service 几乎不用动。一个典型的 StudentDao 查询方法长这样// StudentDao.java只负责 SQL不写业务判断 public ListStudent findByPage(String keyword, int page, int size) throws SQLException { String sql SELECT s.*, c.cname AS className FROM student s LEFT JOIN classes c ON s.class_id c.id WHERE s.name LIKE ? OR s.sno LIKE ? LIMIT ?, ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, % keyword %); ps.setString(2, % keyword %); ps.setInt(3, (page - 1) * size); // 起始偏移量 ps.setInt(4, size); ResultSet rs ps.executeQuery(); ListStudent list new ArrayList(); while (rs.next()) { Student s new Student(); s.setId(rs.getLong(id)); s.setSno(rs.getString(sno)); s.setName(rs.getString(name)); s.setClassName(rs.getString(className)); list.add(s); } return list; } }逻辑说明这里用 LEFT JOIN 把班级名带出来前端就不用再查一次。分页用 LIMIT offset, sizeoffset 是 (page-1)*size这个公式写错会导致第一页数据重复或丢失。参数上 keyword 用 LIKE 两边加百分号注意 PreparedStatement 的占位符不能包在引号里否则会变成字符串匹配。DBUtil 我一般写成静态工具类从 db.properties 读 URL、用户名、密码不要硬编码在 Java 里否则换台电脑就要改代码。2.4 登录拦截Filter 比在每个 Servlet 里判断更省事登录校验如果每个 Servlet 都写一遍 if(session.getAttribute(user)null)代码会重复到你想哭。标准做法是写一个 LoginFilter拦截 /admin/* 路径放行登录页和静态资源。下面这段是过滤器核心逻辑// LoginFilter.java拦截未登录访问 WebFilter(urlPatterns /admin/*) public class LoginFilter implements Filter { Override public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request (HttpServletRequest) req; HttpServletResponse response (HttpServletResponse) resp; Object user request.getSession().getAttribute(loginUser); if (user null) { response.sendRedirect(request.getContextPath() /login.jsp); return; // 必须 return否则会继续放行 } chain.doFilter(req, resp); // 已登录放行 } }逻辑说明WebFilter 是 Servlet 3.0 注解不需要在 web.xml 里再配一遍。urlPatterns 写 /admin/* 表示只拦截后台路径登录页和 css/js 不受影响。注意 sendRedirect 之后必须 return否则代码会继续往下走出现“已经重定向了还执行后面逻辑”的翻车。参数上contextPath 是项目部署路径写死 / 在 Tomcat 换 context 时会 404。3. 在 IDEA 里把项目跑起来环境、依赖、Tomcat 配置3.1 JDK、Tomcat、MySQL 版本对齐表“项目在我电脑上能跑”这句话在毕设里毫无意义因为答辩老师不会用你的电脑。我一般先定一张版本对齐表照着装能省掉一半的排查时间。组件推荐版本不推荐原因JDK8 或 1117老项目 javax.servlet 在 17 上要加模块参数Tomcat8.5 或 9.010Tomcat 10 把 javax 换成 jakartaServlet 全报错MySQL5.7 或 8.08.0 以上需换驱动8.0 驱动类名是 com.mysql.cj.jdbc.DriverIDEA2021 以上太老不认 Maven 新语法社区版没有 Tomcat 集成需手动配这张表里最要命的是 Tomcat 10。很多同学从官网下了最新版 Tomcat 10导入项目后所有 Servlet 报“cannot resolve symbol javax.servlet”因为 Tomcat 10 用的是 jakarta.servlet。解决办法只有两个换 Tomcat 9或者把项目所有 import 改成 jakarta。毕设阶段我建议直接换 Tomcat 9别折腾迁移。3.2 Maven 依赖三个坐标不能少JavaWeb 项目用 Maven 管依赖pom.xml 里至少要有 servlet-api、mysql-connector、jstl 三个。servlet-api 的 scope 必须是 provided因为 Tomcat 自带打进 war 会冲突。dependencies !-- Servlet APITomcat 提供scope 必须 provided -- dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version4.0.1/version scopeprovided/scope /dependency !-- MySQL 驱动8.0 用 cj 驱动 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.28/version /dependency !-- JSTLJSP 页面用 c:forEach 需要 -- dependency groupIdjavax.servlet/groupId artifactIdjstl/artifactId version1.2/version /dependency /dependencies逻辑说明servlet-api 的 provided 是关键如果写成 compile部署到 Tomcat 会和容器自带的类冲突报 ClassCastException。mysql-connector 8.0 的驱动类名是 com.mysql.cj.jdbc.DriverURL 要加 serverTimezoneAsia/Shanghai否则连接时报时区错误。jstl 1.2 对应 JSP 的 c 标签如果页面报“无法解析 c:forEach”先检查这个依赖有没有加。3.3 IDEA 配置 Tomcat 的四个必改项在 IDEA 里配 Tomcat 不是点一下就行有四个地方不改项目必出 404 或 500。第一步Run → Edit Configurations → 加 Tomcat Server → Local在 Deployment 里加 Artifact选 war exploded 而不是 warexploded 支持热更新。第二步Application context 设成 /student不要留 /否则所有路径都要改。第三步在 Server 选项卡里把 On Update action 设成 Update classes and resources改 JSP 不用重启。第四步检查 Project Structure → Modules → WebWeb Resource Directory 要指向 src/main/webapp否则 JSP 找不到。配置完成后启动控制台出现“Artifact student:war exploded: Deployed successfully”才算部署成功。如果启动时端口被占用改 Server 选项卡的 HTTP port不要直接杀进程因为可能是别的项目在跑。3.4 数据库连接工具类db.properties 怎么写DBUtil 我一般写成读配置文件的形式方便换环境。db.properties 放 src/main/resources 下内容四行jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/student_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse jdbc.usernameroot jdbc.password123456逻辑说明URL 里 useUnicode 和 characterEncoding 保证中文不乱码serverTimezone 解决 8.0 驱动的时区异常useSSLfalse 去掉启动时的 SSL 警告。DBUtil 用静态代码块加载驱动getConnection 返回新连接。注意不要用单例连接Servlet 是多线程的共享一个 Connection 会出并发问题这是很多“偶尔报错”的根源。4. 增删改查与分页Servlet 层最容易写错的参数4.1 学生列表分页PageBean 的四个字段分页不是只写个 LIMIT 就完事前端要显示“共 120 条第 3/12 页”所以需要一个 PageBean 封装四个字段list、total、page、size。total 要单独查一次 count(*)不能拿 list.size() 当总数因为 list 只是当前页。// PageBean.java分页结果封装 public class PageBeanT { private ListT list; // 当前页数据 private int total; // 总记录数 private int page; // 当前页码 private int size; // 每页条数 // 计算总页数前端直接用 public int getTotalPage() { return (total size - 1) / size; // 向上取整 } // getter/setter 省略 }逻辑说明getTotalPage 用 (total size - 1) / size 向上取整比如 121 条每页 10 条结果是 13 页。如果写成 total/size121/1012最后一页数据就丢了。参数上page 从 1 开始如果前端传 0 或负数Service 层要兜底改成 1否则 offset 变负数SQL 直接报错。4.2 新增学生的参数校验前端能绕过后端必须再查一遍前端 required 和 maxlength 只是体验后端不校验就是漏洞。新增学生时我一般查三件事学号是否重复、姓名是否为空、班级 id 是否存在。下面这段是 Service 层校验逻辑// StudentService.java新增前校验 public String add(Student s) { if (s.getSno() null || s.getSno().trim().isEmpty()) { return 学号不能为空; } if (studentDao.findBySno(s.getSno()) ! null) { return 学号已存在; // 唯一性校验 } if (s.getClassId() null || classDao.findById(s.getClassId()) null) { return 班级不存在; } studentDao.insert(s); return null; // null 表示成功 }逻辑说明返回 String 而不是 boolean是为了把失败原因带回前端显示。findBySno 查重必须在 insert 之前虽然数据库有唯一索引但直接 insert 会抛 SQLException前端看到的是 500 而不是友好提示。参数上trim() 去掉首尾空格防止用户输入“ 2023001 ”和“2023001”被当成两个学号。4.3 删除与批量删除ids 参数怎么传单个删除传 id批量删除传 ids1,2,3。Servlet 里用 request.getParameterValues(ids) 拿数组或者拿字符串再 split。我一般用字符串拼接 IN 条件但必须用 PreparedStatement 占位符不能直接拼 SQL。// 批量删除ids 是 1,2,3 格式 public void deleteBatch(String ids) { String[] arr ids.split(,); StringBuilder sql new StringBuilder(DELETE FROM student WHERE id IN (); for (int i 0; i arr.length; i) { sql.append(i 0 ? ? : ,?); } sql.append()); try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql.toString())) { for (int i 0; i arr.length; i) { ps.setLong(i 1, Long.parseLong(arr[i])); } ps.executeUpdate(); } catch (SQLException e) { e.printStackTrace(); } }逻辑说明占位符数量根据数组长度动态生成第一个是 ?后面是 ,?。参数绑定从 1 开始对应数组下标 0。注意 Long.parseLong 要包 try-catch如果前端传了非数字会抛 NumberFormatException这个异常在批量操作里很常见因为有人手动改 URL 参数。4.4 修改学生先查再改避免覆盖空字段修改页面通常是先查出来回显用户改完再提交。如果用户没改某个字段前端可能不传后端直接 update 会把该字段置空。我的做法是 update 语句只更新非空字段或者先查原记录再合并。// 动态更新只更新非空字段 public void update(Student s) { StringBuilder sql new StringBuilder(UPDATE student SET ); ListObject params new ArrayList(); if (s.getName() ! null) { sql.append(name?, ); params.add(s.getName()); } if (s.getPhone() ! null) { sql.append(phone?, ); params.add(s.getPhone()); } if (s.getClassId() ! null) { sql.append(class_id?, ); params.add(s.getClassId()); } // 去掉最后一个逗号 sql.setLength(sql.length() - 2); sql.append( WHERE id?); params.add(s.getId()); // 执行更新参数绑定省略 }逻辑说明动态 SQL 的好处是前端只传要改的字段不会误清空其他列。注意 setLength 去掉末尾逗号这个操作在拼接 SQL 时很常用。参数上id 必须放最后对应 WHERE 条件。如果所有字段都为空SQL 会变成“UPDATE student SET WHERE id?”直接语法错误所以 Service 层要先判断至少有一个字段非空。5. 避坑与排查那些让项目起不来的常见问题5.1 启动报 404先看 Application context 和 web.xml现象Tomcat 启动成功访问 http://localhost:8080/ 显示 404。原因通常是 Application context 没设或者 web.xml 里 welcome-file 没配。解决在 IDEA 的 Tomcat 配置里把 Application context 设成 /student访问 http://localhost:8080/student/login.jsp。如果 web.xml 的 servlet-mapping 写的是 /student/*那访问路径要对应。还有一种情况是 webapp 目录下没有 index.jspwelcome-file 默认找 index.html、index.jsp都没有就 404。5.2 中文乱码三处编码要统一现象表单提交后数据库里是问号或者页面显示乱码。原因有三处JSP 页面 pageEncoding、request 编码、数据库连接编码。解决JSP 头部写 % page contentTypetext/html;charsetUTF-8 pageEncodingUTF-8 %Servlet 里在取参数前调 request.setCharacterEncoding(UTF-8)db.properties 的 URL 加 characterEncodingutf8。三处缺一处都会乱码这是血泪经验我见过只改 JSP 不改 request 的POST 提交照样乱。5.3 ClassNotFoundException: com.mysql.cj.jdbc.Driver现象启动时报找不到 MySQL 驱动。原因通常是 Maven 依赖没加或者加了但没打进 WEB-INF/lib。解决检查 pom.xml 有没有 mysql-connector-java然后在 IDEA 的 Project Structure → Artifacts 里看 WEB-INF/lib 下有没有这个 jar。如果没有在 Artifact 里右键 Add Library 手动加。另一个原因是驱动类名写错5.x 是 com.mysql.jdbc.Driver8.x 是 com.mysql.cj.jdbc.Driver版本和类名必须对应。5.4 Session 失效登录后刷新又跳回登录页现象登录成功点几个页面后突然跳回登录页。原因通常是 Session 超时或者 Tomcat 重启导致 Session 丢失。解决在 web.xml 里配 session-configtimeout 设 30 分钟开发阶段 Tomcat 重启频繁Session 会清空这是正常的重新登录即可。如果生产环境频繁掉线检查是不是用了集群但没做 Session 共享。毕设阶段单机 Tomcat 一般不会出这个问题除非你手动调了 session-timeout 为 1 分钟。5.5 JSTL 标签不解析页面直接显示 c:forEach现象JSP 页面把 c:forEach 当普通文本输出。原因通常是 jstl 依赖没加或者 taglib 指令写错。解决pom.xml 加 jstl 1.2JSP 头部写 % taglib prefixc urihttp://java.sun.com/jsp/jstl/core %。注意 uri 是 java.sun.com 不是 jakartaTomcat 9 及以下都用这个。如果还不行检查 web.xml 的版本2.3 版本不支持 JSTL要改成 3.0 以上。6. 从原生 JavaWeb 到 Spring Boot毕设选题的升级路径如果你已经跑通了上面这套原生 Servlet JSP 的方案答辩基本没问题。但如果你想让毕设看起来更“现代”或者导师明确要求用 Spring Boot那可以在现有基础上做一次渐进式升级而不是推倒重来。我的做法是保留数据库和前端页面把 Servlet 层换成 Spring MVC 的 ControllerDAO 换成 MyBatis 的 MapperService 层几乎不用动。第一步加 Spring Boot 依赖。在 pom.xml 里引入 spring-boot-starter-web 和 mybatis-spring-boot-starter把原来的 war 打包改成 jar内嵌 Tomcat 就不需要单独配了。第二步把 DBUtil 换成 application.yml 里的数据源配置连接池用 HikariCPSpring Boot 默认自带。第三步把 StudentDao 改成 StudentMapper 接口方法上写 Select 注解或者用 XML 映射SQL 语句可以直接复制过来。第四步把 StudentServlet 改成 StudentController用 RestController 或 Controller参数用 RequestParam 接收返回值用 ResponseBody 转 JSON。// Spring Boot 版 Controller对比原生 Servlet RestController RequestMapping(/api/student) public class StudentController { Autowired private StudentService studentService; GetMapping(/page) public PageBeanStudent page(RequestParam(defaultValue ) String keyword, RequestParam(defaultValue 1) int page, RequestParam(defaultValue 10) int size) { return studentService.findByPage(keyword, page, size); } PostMapping(/add) public Result add(RequestBody Student student) { String msg studentService.add(student); return msg null ? Result.ok() : Result.fail(msg); } }逻辑说明RestController 等于 Controller ResponseBody返回对象自动转 JSON前端用 axios 调就行。RequestParam 的 defaultValue 处理不传参的情况比原生 Servlet 里手动判 null 优雅。RequestBody 接收 JSON 格式的提交和原生表单提交的区别是 Content-Type 要设 application/json。参数上page 和 size 给了默认值前端不传也能正常分页。升级后前端页面可以从 JSP 换成 Vue 或 Thymeleaf但毕设阶段我建议保留 JSP因为改前端工作量太大而且答辩老师更看重后端逻辑。如果你时间充裕可以把列表页换成 Vue Element UI用 axios 调 /api/student/page这样整个项目就是“Spring Boot Vue”的架构选题上更贴近“基于 Spring Boot 的毕设”这个热搜方向。最后说一个我自己的习惯不管用原生 JavaWeb 还是 Spring Boot我都会在项目根目录放一个 README.md写清楚 JDK 版本、Tomcat 版本、MySQL 版本、数据库导入步骤、默认账号密码。答辩前自己按 README 从零部署一遍能跑通再交。这个习惯帮我省掉了至少三次“现场演示翻车”的后悔药。希望帮到你。本文还有配套的精品资源点击获取