简介：这是一套面向JavaWeb初学者与课程设计开发者的学生成绩管理系统完整源码，基于Servlet、JSP与MySQL技术栈实现，在原项目基础上新增了ECharts统计图表功能，可用于毕业设计、课程作业或框架入门练习。压缩包共344个文件，约3.59MB，其中86个Java源文件与86个class文件构成后端业务与DAO分层实现，37个JSP页面负责视图展示，62个JS与28个CSS文件支撑前端交互与样式，另含6个jar依赖、1个sql建表脚本及字体、图片等静态资源，目录结构完整可直接导入运行。资源已有6724人学习下载，热度较高。读者可从中获取成绩录入、查询、修改、删除等核心模块的完整实现思路，理解Servlet控制层、Service业务层与Dao数据层的分层设计，并参考ECharts统计图的接入方式，快速搭建可运行的学生成绩管理项目，适合作为JavaWeb综合实践的参考范例。
1. 从一份 Servlet+JSP+MySQL 的成绩管理系统源码说起：它到底能跑通什么
如果你手头正压着一个 JavaWeb 课设或者实训任务，要求做一套学生成绩管理系统，还要带 ECharts 统计图，那这份基于 Servlet+JSP+MySQL 的源码包大概率能让你少熬两个通宵。它不是那种只放几张截图、代码缺胳膊少腿的“演示版”，而是一套能完整跑通增删改查、分角色登录、成绩录入与统计图表渲染的传统 MVC 项目。技术栈很明确：后端用原生 Servlet 处理请求，JSP 负责视图渲染，MySQL 存数据，前端用 ECharts 把成绩分布、班级均分这类数据画成柱状图和饼图。适合谁？正在学 JavaWeb 三件套、需要交课程设计、或者想拿一个“不依赖 Spring 全家桶”的干净项目练手的人。你拿到手最关心的无非三件事：环境能不能快速搭起来、数据库脚本全不全、统计图的数据链路是不是真的从 SQL 查出来的。下面按我实际拆包复现的顺序，把每一步和容易翻车的地方都摊开讲。
2. 环境搭建与数据库初始化：把 Tomcat、JDK、MySQL 版本对齐
2.1 版本选型：为什么这套源码不建议上 JDK 17
传统 Servlet+JSP 项目对版本比较敏感。源码里用的是javax.servlet包，不是jakarta.servlet，这意味着你必须用 Tomcat 9.x 及以下版本，JDK 建议 8 或 11。如果你头铁上了 Tomcat 10，启动直接报ClassNotFoundException: javax.servlet.http.HttpServlet，因为 Tomcat 10 把包名换成了jakarta.*。MySQL 用 5.7 或 8.0 都行，但 8.0 要改驱动类名和连接串参数。我一般会先确认三件事：java -version输出是不是 1.8 或 11，Tomcat 的lib目录下有没有servlet-api.jar，MySQL 服务能不能正常连。这三样对齐了，后面 80% 的玄学问题都不会出现。
2.2 导入数据库：建库、建表、插初始数据
源码包里通常有一个.sql文件，我习惯先用命令行导入，比图形化工具少踩编码坑。步骤是：先建库，再选库，最后执行脚本。
# 登录 MySQL，注意 -p 后面直接跟密码有安全提示，回车后再输入更稳妥 mysql -u root -p # 建库，字符集用 utf8mb4，避免中文姓名和课程名乱码 CREATE DATABASE student_score DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 切换到该库 USE student_score; # 导入表结构和初始数据，路径换成你实际存放 sql 文件的位置 source /path/to/student_score.sql;执行完用SHOW TABLES;确认表都建出来了。常见的有student、teacher、course、score、user这几张。如果导入时报ERROR 1366 Incorrect string value，说明脚本里的字符集和库不一致，把建库语句的utf8mb4改成utf8再试，或者用编辑器把 sql 文件转成 UTF-8 无 BOM 格式。这一步别偷懒，编码问题拖到后面查会非常痛苦。
2.3 改配置文件：数据库连接串和项目上下文
数据库通了之后，去源码里找数据库连接配置。原生 Servlet 项目一般有两种写法：一种是在src下放db.properties，一种是把连接参数硬编码在某个DBUtil.java里。找到后重点改四个值：URL、用户名、密码、驱动类。
// 常见于 DBUtil.java 或 BaseDao.java 中 private static final String URL = "jdbc:mysql://localhost:3306/student_score?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false"; private static final String USER = "root"; private static final String PASSWORD = "你的密码"; private static final String DRIVER = "com.mysql.cj.jdbc.Driver"; // MySQL 8.0 用 cj，5.7 用 com.mysql.jdbc.DriverserverTimezone这个参数在 MySQL 8.0 下必须加，否则报The server time zone value '?D1ú±ê×?ê±??' is unrecognized。useSSL=false是关掉 SSL 警告，本地开发无所谓。改完把项目部署到 Tomcat 的webapps目录，或者直接在 IDE 里配 Tomcat 运行。访问路径一般是http://localhost:8080/项目名/login.jsp。如果 404，检查web.xml里的url-pattern和你的访问路径是否一致。
3. 核心功能链路拆解：登录、成绩 CRUD 与 ECharts 数据接口
3.1 登录与权限拦截：Session 里到底存了什么
这套系统的登录逻辑不复杂，但它是理解整个请求链路的入口。用户在login.jsp提交表单，LoginServlet拿到用户名密码，去user表里查，查到了就把用户信息塞进HttpSession，然后根据角色跳转到不同页面。学生看到的是自己的成绩查询，教师看到的是成绩录入和统计。关键代码在 Servlet 的doPost方法里：
// LoginServlet.java 核心逻辑 protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String username = request.getParameter("username"); String password = request.getParameter("password"); User user = userService.login(username, password); // 底层就是一条 select if (user != null) { HttpSession session = request.getSession(); session.setAttribute("currentUser", user); // 存整个用户对象 session.setAttribute("role", user.getRole()); // 单独存角色，方便 JSP 里判断 if ("teacher".equals(user.getRole())) { response.sendRedirect("teacher/score_list.jsp"); } else { response.sendRedirect("student/my_score.jsp"); } } else { request.setAttribute("msg", "用户名或密码错误"); request.getRequestDispatcher("login.jsp").forward(request, response); } }这里有个容易忽略的点：sendRedirect和forward的区别。登录成功用重定向，防止刷新页面重复提交表单；登录失败用转发，能把错误信息带回去。另外，Session 里存了currentUser之后，后续所有需要登录才能访问的 Servlet 都应该先检查session.getAttribute("currentUser")是否为空，为空就踢回登录页。源码里如果没做这个拦截，你自己加一个LoginFilter会更稳妥。
3.2 成绩录入与查询：一条 SQL 从表单到列表
成绩管理的主体是score表，通常包含student_id、course_id、score这几个字段。教师录入成绩时，JSP 表单提交到ScoreServlet，Servlet 调用 DAO 层执行INSERT或UPDATE。查询列表则是SELECT配合JOIN把学生姓名、课程名一起查出来。
-- 成绩列表查询，关联三张表拿到可读信息 SELECT s.id, st.name AS student_name, c.name AS 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;对应的 Servlet 里，doGet根据action参数决定是查全部还是查个人。比如action=list走全量查询，action=my走带student_id条件的查询。这里常见的坑是中文参数乱码。如果表单提交后收到的课程名是乱码，在 Servlet 第一行加request.setCharacterEncoding("UTF-8");，并且确保 JSP 页面顶部是<%@ page contentType="text/html;charset=UTF-8" language="java" %>。Tomcat 8 以后 GET 请求默认 UTF-8，但 POST 请求必须手动设。
3.3 ECharts 统计图：数据从 SQL 到前端的完整链路
新增的 ECharts 统计图是这套源码的加分项。它的实现思路很直接：后端提供一个返回 JSON 的 Servlet，前端用 Ajax 请求这个接口，拿到数据后交给 ECharts 渲染。以“班级成绩分布”为例，后端 SQL 按分数段分组统计人数：
-- 按分数段统计人数，用于柱状图 SELECT CASE WHEN score >= 90 THEN '优秀' WHEN score >= 80 THEN '良好' WHEN score >= 70 THEN '中等' WHEN score >= 60 THEN '及格' ELSE '不及格' END AS level, COUNT(*) AS count FROM score GROUP BY level;后端 Servlet 把结果集转成 JSON 字符串，前端 JSP 里这样接：
// 在统计页面引入 echarts.min.js 后 var chart = echarts.init(document.getElementById('scoreChart')); $.ajax({ url: 'ChartServlet?type=distribution', // 指向返回 JSON 的 Servlet type: 'GET', dataType: 'json', success: function (data) { var option = { title: { text: '成绩分布统计' }, tooltip: {}, xAxis: { data: data.levels }, // 后端返回的等级数组 yAxis: {}, series: [{ name: '人数', type: 'bar', data: data.counts // 后端返回的人数数组 }] }; chart.setOption(option); }, error: function () { alert('统计图数据加载失败，检查 ChartServlet 是否正常返回 JSON'); } });这里的关键是后端返回的 JSON 格式必须和前端data.levels、data.counts对应上。我见过有人后端返回的是[{level:'优秀',count:5},...]这种对象数组，前端却按两个平行数组去取，结果图是空的。排查时直接在浏览器地址栏访问ChartServlet?type=distribution，看返回的 JSON 长什么样，比在代码里猜快得多。另外 ECharts 的容器div必须给明确高度，否则图渲染不出来，这是新手最常翻的车。
4. 避坑与排查：这套源码跑不起来时先查这五处
4.1 现象：Tomcat 启动报 404，项目根本没部署上
原因通常是项目没有正确放到webapps目录，或者 IDE 里配的 Artifact 有问题。解决：检查 Tomcat 的webapps下有没有你的项目文件夹，里面有没有WEB-INF和index.jsp。如果在 IDE 里跑，去 Run Configuration 确认 Deployment 选项卡里 Artifact 已经添加。另一个隐蔽原因是web.xml里<welcome-file>配的首页文件不存在，Tomcat 找不到默认页也会 404。
4.2 现象：数据库连不上，报 Access denied 或 Communications link failure
先确认 MySQL 服务在跑，net start mysql或systemctl status mysql。然后确认用户名密码和DBUtil里写的一致。Communications link failure多半是端口不对或者 MySQL 没启动，默认 3306，如果你改过端口要同步改连接串。还有一种情况是 MySQL 8.0 的caching_sha2_password认证插件导致旧驱动连不上，解决办法是改用户认证方式或者换用mysql-connector-java-8.0.x的驱动 jar。
4.3 现象：中文乱码，学生姓名和课程名全是问号
三个地方要同时设 UTF-8：数据库建库时CHARACTER SET utf8mb4，JSP 页面pageEncoding="UTF-8"，Servlet 里request.setCharacterEncoding("UTF-8")。如果还乱，检查 Tomcat 的server.xml里 Connector 有没有加URIEncoding="UTF-8"。另外用source命令导入 sql 文件时，如果文件本身是 GBK 编码，也会导致存进去就是乱码，用file -i xxx.sql看一下编码，转成 UTF-8 再导。
4.4 现象：ECharts 图不显示，页面空白但控制台没报错
最常见的原因是容器div没有设高度。ECharts 初始化时需要知道画布尺寸，如果div高度是 0，图就渲染不出来。给#scoreChart加style="width:100%;height:400px;"即可。其次检查echarts.min.js的引入路径对不对，F12 看 Network 里这个 js 是不是 404。最后确认 Ajax 请求的ChartServlet返回的Content-Type是application/json，如果返回的是text/html，dataType:'json'解析会失败，走 error 回调。
4.5 现象：修改代码后刷新页面没变化，还是旧逻辑
这是 Tomcat 缓存和 JSP 编译机制导致的。JSP 修改后一般会自动重新编译，但 Java 类修改后必须重启 Tomcat 才生效。如果你在 IDE 里开了热部署但没生效，去 Tomcat 的work目录把对应项目的缓存文件夹删掉，重启。另外浏览器缓存也可能让你看到旧页面，Ctrl+F5 强制刷新。我一般改完 Servlet 代码后直接重启 Tomcat，比等热部署靠谱。
5. 进阶技巧：把统计图数据接口做成通用查询，以及我的验证习惯
这套源码的 ECharts 部分目前是写死的几个统计维度，比如成绩分布、班级均分。如果你想让它更灵活，可以把ChartServlet改成一个通用接口，通过type参数决定执行哪条 SQL，返回统一格式的 JSON。这样加新图表时只需要加一个case分支和对应的 SQL，前端不用动。我一般会这样组织：
// ChartServlet 里根据 type 分发查询 String type = request.getParameter("type"); List<Map<String, Object>> result; switch (type) { case "distribution": result = chartDao.getScoreDistribution(); break; case "classAvg": result = chartDao.getClassAverage(); break; case "coursePass": result = chartDao.getCoursePassRate(); break; default: result = Collections.emptyList(); } // 统一转成 {categories:[], values:[]} 结构返回 response.setContentType("application/json;charset=UTF-8"); response.getWriter().write(JSON.toJSONString(formatChartData(result)));这样前端所有图表都按同一套categories和values去取，复用性高很多。验证方法也简单：每加一个type，先在浏览器直接访问ChartServlet?type=xxx，确认 JSON 结构对，再去页面上看图表。我习惯在formatChartData里加一行日志，把转换后的 JSON 打到控制台，这样前端拿不到数据时，一眼就能判断是后端没查出来还是前端解析错了。
另外，这套系统如果要拿去做课设答辩，建议把web.xml里的 Servlet 配置改成注解方式@WebServlet("/ChartServlet")，少一层 XML 配置，演示时更清爽。数据库连接池也可以从裸 JDBC 换成 Druid 或 C3P0，虽然源码里没带，但加进去之后并发查询成绩时不会频繁创建连接，答辩时也是个加分项。从那以后我每次拿到这类传统 JavaWeb 项目，都强制先跑通数据库连接和登录，再去看业务代码，顺序反了就会在环境问题上浪费大量时间。希望帮到你。
本文还有配套的精品资源，点击获取
