Jsp+MySQL学生成绩管理系统：从环境搭建到二次开发全攻略

简介这是一套基于JavaWeb技术栈的学生成绩管理系统完整源码采用JSPServletMySQL架构面向计算机相关专业正在做课程设计、期末大作业的学生以及需要项目实战练习的学习者。项目为个人大三学期期末大作业经导师指导并认可通过评审分98分可直接作为课程设计或毕业设计参考。压缩包共353个文件约9.85MB包含53个java源文件与53个class编译文件、24个jsp页面、40个css样式、10个js脚本及24个jar依赖另附sql建库脚本与db数据库文件覆盖成绩录入、查询、统计、导出等核心业务模块并配有Excel导出工具类与验证码生成类。目前已有198人学习下载。读者可从中获得完整的项目目录结构、分层设计思路与数据库表结构便于快速理解JavaWeb开发流程、对照调试代码并完成自己的大作业。1. 从一份 98 分课设说起Jsp MySQL 的学生成绩管理系统到底该怎么落地每年毕业季总有一批人卡在同一个地方课设选题定了「学生成绩管理系统」技术栈写的是 JavaWeb Jsp MySQL听起来四平八稳真动手才发现从建库到跑通登录能折腾一整周。这份 98 分项目的核心价值不在于功能多花哨而在于它把一套传统 Jsp 项目的完整骨架跑通了——数据库文件、表结构、增删改查、分页、权限区分一个都不少。它适合三类人正在做 Java 课程设计的学生、想拿一个完整案例练手 JavaWeb 的初学者、以及需要一套能直接改造成毕设的模板的开发者。你拿到源码不等于能跑起来真正的门槛在环境配置、数据库导入和 Jsp 页面路径这三处。下面按「先跑通、再理解、后改造」的顺序拆开讲。2. 环境准备与项目导入把 Jsp MySQL 项目在本地跑起来2.1 JDK、Tomcat、MySQL 的版本匹配逻辑传统 Jsp 项目对版本很敏感不是随便装个最新版就能跑。常见做法是 JDK 8 Tomcat 8.5 或 9 MySQL 5.7 或 8.0 这套组合原因是老项目的 Servlet 和 Jsp 标签库大多基于 Java EE 规范Tomcat 10 之后包名从javax.*改成jakarta.*直接部署会报ClassNotFoundException。MySQL 8.0 的驱动类名是com.mysql.cj.jdbc.Driver5.7 是com.mysql.jdbc.Driver连接串里还要注意时区和 SSL 参数否则控制台会刷一堆警告。安装 MySQL 时如果用的是解压版记得手动初始化并设置 root 密码命令如下# 初始化 MySQL 数据目录解压版首次使用 mysqld --initialize-insecure --basedirD:\mysql-8.0 --datadirD:\mysql-8.0\data # 注册为 Windows 服务并启动 mysqld --install MySQL80 --defaults-fileD:\mysql-8.0\my.ini net start MySQL80 # 登录后修改 root 密码 mysql -u root -p ALTER USER rootlocalhost IDENTIFIED BY your_password;--initialize-insecure表示初始化时不生成随机密码方便首次登录--defaults-file指定配置文件路径避免服务找不到my.ini。如果你在 Linux 上装把服务注册换成systemctl即可核心参数一致。2.2 用 IDEA 导入项目并配置 TomcatIDEA 新建 Jsp 项目时很多人卡在「没有 Web 模块」这一步。正确流程是先建 Java 项目再在项目结构里添加 Web Facet或者直接用 Maven 的war打包方式。导入现成源码时重点检查三处配置配置项位置常见值Web 资源目录Project Structure → Facetssrc/main/webapp或web编译输出路径Project Structure → Artifactsout/artifacts/项目名_war_exploded依赖库Project Structure → LibrariesWEB-INF/lib下的 jar 包如果项目用的是普通 Java Web 结构非 Mavenjar 包通常放在WEB-INF/lib下IDEA 需要手动把这些 jar 加入模块依赖否则编译期就报「找不到符号」。配置 Tomcat 时Deployment 选项卡里选war exploded模式这样改 Jsp 页面不用重启服务器刷新浏览器就能看到效果。2.3 导入数据库文件与修改连接配置源码里一般会带一个.sql文件用 Navicat 或命令行导入都行。命令行方式更稳# 创建数据库并导入表结构和数据 mysql -u root -p -e CREATE DATABASE student_score DEFAULT CHARACTER SET utf8mb4; mysql -u root -p student_score student_score.sql # 验证导入结果 mysql -u root -p -e USE student_score; SHOW TABLES; SELECT COUNT(*) FROM student;导入后必须改项目里的数据库连接配置通常在db.properties或DBUtil.java里。连接串建议写成jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/student_score?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse jdbc.usernameroot jdbc.passwordyour_passwordserverTimezone不写会报时区错误useSSLfalse是本地开发省去证书配置生产环境要另说。改完配置后启动 Tomcat访问http://localhost:8080/项目名/能看到登录页就算跑通了。3. 核心功能模块拆解登录、成绩录入与分页查询怎么实现3.1 登录鉴权与 Session 管理Jsp 项目的登录逻辑一般写在 Servlet 里流程是接收表单参数 → 查数据库比对 → 成功则写 Session → 跳转主页。核心代码结构如下// LoginServlet.java 关键片段 String username request.getParameter(username); String password request.getParameter(password); User user userDao.findByUsername(username); if (user ! null user.getPassword().equals(password)) { HttpSession session request.getSession(); session.setAttribute(currentUser, user); session.setAttribute(role, user.getRole()); response.sendRedirect(main.jsp); } else { request.setAttribute(msg, 用户名或密码错误); request.getRequestDispatcher(login.jsp).forward(request, response); }这里有两个容易翻车的点一是密码明文比对课设够用但毕设答辩会被问建议至少加个 MD5二是 Session 超时时间没设默认 30 分钟可以在web.xml里配session-config调整。权限区分靠role字段学生登录只能查自己的成绩教师能录入和修改管理员管用户。3.2 成绩录入的 SQL 与事务处理成绩录入涉及多表操作时事务不能省。比如录入一条成绩要同时更新score表和student表的统计字段就得手动控制提交Connection conn null; try { conn DBUtil.getConnection(); conn.setAutoCommit(false); scoreDao.insert(conn, score); studentDao.updateTotalCredit(conn, studentId); conn.commit(); } catch (Exception e) { if (conn ! null) conn.rollback(); e.printStackTrace(); } finally { DBUtil.close(conn); }setAutoCommit(false)关闭自动提交commit()和rollback()成对出现。参数说明score对象里至少包含学生 ID、课程 ID、分数、学期四个字段数据库表要有对应的唯一索引防止重复录入。如果并发量不大这套写法足够真要扛并发连接池和乐观锁得另加。3.3 分页查询的两种实现与选择分页是成绩管理系统里最常被问的功能。常见做法有两种一是用LIMIT做物理分页二是查全量再在 Jsp 里截取。后者数据量一大就内存爆炸不推荐。物理分页的 SQL 模板-- 查询第 page 页每页 size 条 SELECT s.id, st.name, c.course_name, s.score FROM score s JOIN student st ON s.student_id st.id JOIN course c ON s.course_id c.id ORDER BY s.id DESC LIMIT #{offset}, #{size};offset (page - 1) * sizesize一般设 10 或 20。Jsp 页面里用 JSTL 的c:forEach遍历结果分页条根据总记录数算出总页数。注意 MySQL 的LIMIT在大偏移量时性能会下降课设数据量小无所谓数据上万后要考虑游标或索引优化。4. 避坑与排查Jsp MySQL 项目最容易翻车的 5 个地方4.1 中文乱码从数据库到页面的全链路排查现象录入中文姓名后页面显示问号或乱码。原因通常有三层数据库字符集不是utf8mb4、连接串没加characterEncodingutf8、Jsp 页面没声明pageEncoding。解决顺序是先用SHOW VARIABLES LIKE character%;确认数据库字符集再检查连接串最后在 Jsp 顶部加% page contentTypetext/html;charsetUTF-8 pageEncodingUTF-8 %。三层都对齐基本不会乱。4.2 驱动加载失败ClassNotFoundException 的三种可能现象启动时报java.lang.ClassNotFoundException: com.mysql.jdbc.Driver。原因一是 jar 包没放进WEB-INF/lib二是 MySQL 8.0 用了旧驱动类名三是 Tomcat 的 lib 目录和项目 lib 目录冲突。解决确认mysql-connector-java的版本和驱动类名匹配8.0 用com.mysql.cj.jdbc.Driverjar 包只放项目WEB-INF/lib下不要重复放 Tomcat 的 lib。4.3 404 与 500路径问题和空指针的区分现象访问页面报 404 或 500。404 多半是 URL 写错或web.xml里 Servlet 映射不对检查WebServlet(/login)和表单action是否一致。500 常见是空指针比如session.getAttribute(currentUser)返回 null 后直接调方法。解决在 Servlet 里先判空再操作Jsp 里用c:if包住可能为 null 的变量。4.4 数据库连接未关闭导致 Tomcat 启动变慢现象反复调试后 Tomcat 启动越来越慢甚至报连接数超限。原因是每次请求都新建 Connection 却没关连接池耗尽。解决用finally块确保close()或者直接上 Druid、C3P0 连接池。课设阶段手写DBUtil可以但一定要在finally里关资源。4.5 war 包部署到独立 Tomcat 后页面样式丢失现象IDEA 里跑正常打成 war 包丢到 Tomcat 的webapps下CSS 和图片全 404。原因是 Jsp 里用了相对路径war 解压后目录层级变了。解决统一用c:url或${pageContext.request.contextPath}拼绝对路径比如link href${pageContext.request.contextPath}/css/style.css。5. 从能跑到能改二次开发与答辩加分技巧项目跑通只是起点真正拉开差距的是你能不能在这套源码上做出自己的东西。我一般会先做一件事把数据库表结构画出来标清主外键关系然后挑一个模块做增强。比如成绩查询模块原版只支持按学号查你可以加一个按课程和分数段筛选的功能SQL 里用动态WHERE拼接前端用下拉框传参。这个改动不大但答辩时能讲清楚「我做了什么、为什么这么做」。另一个加分点是加一层简单的日志。不用上 Log4j 那么重写个OperateLog表在增删改的 Servlet 里插一条记录字段包括操作人、操作类型、时间、IP。代码就几行// 在增删改操作成功后调用 OperateLog log new OperateLog(); log.setUserId((Integer) session.getAttribute(userId)); log.setAction(录入成绩); log.setIp(request.getRemoteAddr()); log.setCreateTime(new Date()); logDao.insert(log);request.getRemoteAddr()拿客户端 IP本地测试是127.0.0.1。这个功能实现成本低但能让答辩老师看到你有工程意识不是只抄了个模板。验证方法上我习惯用 Postman 先把后端接口跑一遍确认参数和返回值没问题再回到 Jsp 页面调前端。这样出问题时能快速定位是后端逻辑还是页面渲染的锅。最后留一句血泪经验改任何配置前先备份一份能跑的版本不然改崩了连后悔药都没得吃。希望帮到你。本文还有配套的精品资源点击获取