简介这是一套基于Java Web经典技术栈ServletJSPMySQL开发的学生成绩管理系统完整源码与配套文档专为高校计算机专业学生设计适用于Java Web课程设计、期末大作业及基础项目实践帮助学习者系统掌握MVC分层架构、数据库交互、前后端协同与CRUD全流程开发。资源共188个文件包含42个JSP页面实现用户界面与交互、24个Java类含GradeDao、StudentDao、LoginServlet等核心业务与控制逻辑、72个编译后Class文件、6个SQL建表与初始化脚本、9个Jar依赖库以及CSS/JS/HTML等前端资源压缩包仅11.29MB结构清晰、模块解耦明确。已有223人下载学习所有代码均经本地实测可运行评审得分98分附带完整设计报告内容经助教审定覆盖需求分析、数据库设计、功能模块说明与部署指南切实降低入门门槛提升工程实践能力。1. 为什么这个“JavaServletJSPMySQL学生成绩管理系统”至今仍是Java Web入门绕不开的硬核练手项目不是因为它多酷炫——它没有Vue响应式界面不跑在Docker里也不对接微信小程序恰恰相反它土得掉渣一个WAR包丢进Tomcat靠% %拼HTML用request.getParameter()接表单SQL写在Java里还带字符串拼接。但正因如此它像一台拆开的机械手表齿轮咬合清晰、动力传递可见、每个故障点都暴露在眼皮底下。你改一行doPost()逻辑页面立刻报500删掉web.xml里一个servlet-mapping整个成绩录入页就404MySQL字段少设个NOT NULL插入空值时连SQLException堆栈都懒得打全。这系统不是教你怎么“快速上线”而是逼你亲手把HTTP请求怎么变成数据库记录、JSP怎么被编译成Servlet、Tomcat线程池怎么被耗尽、事务隔离级别怎么影响同班同学查分结果——这些在Spring Boot自动配置下早已黑盒化的环节全在这里裸奔。适合刚写完HelloWorld、正卡在“Java能干啥”和“Web到底啥结构”之间的新人也适合面试前想亲手验证Servlet生命周期是不是真如八股文写的那样“init→service→destroy”或者想确认JSP隐式对象里pageContext到底能不能跨页面传值的老手。它不教你架构设计但教你怎么让代码不崩——这是所有高阶能力的地基。2. 搭建最小可运行环境从零配通TomcatMySQLIDEA避开90%新手卡点2.1 JDK与Tomcat版本对齐别让Java 17毁掉你的第一个HttpServlet很多新手栽在第一步下载了最新版JDK 21却用Tomcat 9仅支持到Java 11结果启动时直接报UnsupportedClassVersionError。这不是配置问题是版本契约断裂。必须严格匹配组件推荐版本理由JDKJava 81.8或 Java 11Servlet 3.1规范要求且绝大多数教学源码基于此开发Java 17需Tomcat 10但JSP支持已移除Tomcat 10默认用Jakarta EE 9命名空间javax.*全变jakarta.*TomcatTomcat 8.5.x 或 Tomcat 9.0.x兼容Servlet 3.1/4.0稳定支持JSP 2.3Windows/Linux双平台无坑MySQLMySQL 5.7 或 8.0开启传统认证模式避免MySQL 8.0默认caching_sha2_password插件导致JDBC连接失败提示下载Tomcat后务必检查bin/catalina.batWindows或bin/catalina.shLinux顶部的JAVA_HOME路径是否指向你实际安装的JDK 8/11目录。别信IDEA里设置的SDK——Tomcat启动时只认系统环境变量或脚本内硬编码路径。2.2 IDEA新建动态Web项目拒绝向导式陷阱手动配web.xml才是真入门IDEA的“New Project → Jakarta EE”向导会自动生成web.xml并设为Servlet 4.0但教学源码普遍基于Servlet 3.1且大量依赖web.xml显式配置如welcome-file-list、filter顺序。必须手动创建标准结构your-project/ ├── src/ │ └── main/ │ ├── java/ # Servlet类放这里 │ └── resources/ # db.properties等配置文件 ├── webapp/ │ ├── WEB-INF/ │ │ ├── web.xml # 手动创建非IDEA自动生成 │ │ └── lib/ # 放mysql-connector-java-5.1.47.jar勿用8.x │ ├── index.jsp │ └── css/js/img/ # 静态资源关键步骤新建Module → Maven → 勾选“Create from archetype” → 选maven-archetype-webapp不要选任何Spring或Jakarta模板右键Project → Add Framework Support → Web Applicationversion 3.1手动创建webapp/WEB-INF/web.xml内容必须含web-app根节点及version3.1属性?xml version1.0 encodingUTF-8? web-app xmlnshttp://xmlns.jcp.org/xml/ns/javaee xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd version3.1 display-nameStudentScoreSystem/display-name welcome-file-list welcome-fileindex.jsp/welcome-file /welcome-file-list /web-app参数说明version3.1是硬性要求——Servlet 3.1规范才定义WebServlet注解但教学源码多用XML配置且Tomcat 8.5默认解析3.1 schema。若写成4.0部分老源码的servlet-class路径可能被IDEA误判为无效。2.3 MySQL连接池实战别再用Class.forName()DriverManager.getConnection()写死密码源码里常见DBUtil.java直接new com.mysql.jdbc.Driver()这在生产环境是定时炸弹每次查询都新建连接100并发瞬间打爆MySQL。必须上连接池但别碰HikariCP太重或Druid配置复杂用Tomcat自带的BasicDataSource最稳妥在webapp/WEB-INF/lib/放入commons-dbcp-1.4.jar和commons-pool-1.6.jarTomcat 8.5兼容在webapp/WEB-INF/web.xml中添加资源引用resource-ref descriptionDB Connection/description res-ref-namejdbc/StudentDB/res-ref-name res-typejavax.sql.DataSource/res-type res-authContainer/res-auth /resource-ref在conf/context.xmlTomcat全局或webapp/META-INF/context.xml项目级中配置数据源?xml version1.0 encodingUTF-8? Context Resource namejdbc/StudentDB authContainer typejavax.sql.DataSource factoryorg.apache.tomcat.dbcp.dbcp.BasicDataSourceFactory maxActive20 maxIdle10 minIdle5 initialSize5 driverClassNamecom.mysql.jdbc.Driver urljdbc:mysql://localhost:3306/studentdb?useSSLfalseamp;serverTimezoneGMT%2B8 usernameroot password123456 validationQuerySELECT 1 testOnBorrowtrue/ /Context逻辑说明factoryorg.apache.tomcat.dbcp.dbcp.BasicDataSourceFactory指定Tomcat DBCP工厂类validationQuerySELECT 1确保连接有效性testOnBorrowtrue每次借连接时校验避免拿到失效连接。URL中useSSLfalse是MySQL 5.7必需参数否则报SSL握手失败serverTimezoneGMT%2B8解决时区错误否则存入时间全错8小时。3. 核心功能落地从登录验证到成绩录入手撕三层结构每一行代码3.1 登录模块LoginServlet如何用Session实现状态保持教学源码常把登录逻辑写在JSP里% if(request.getParameter(login)!null){...}%这是反模式。必须分离Servlet处理业务JSP只负责展示。LoginServlet.java核心逻辑WebServlet(/login) public class LoginServlet extends HttpServlet { protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String username request.getParameter(username); String password request.getParameter(password); // 1. 调用DAO验证用户此处简化实际应查库 boolean isValid admin.equals(username) 123.equals(password); if (isValid) { // 2. 创建Session并存用户信息 HttpSession session request.getSession(true); // true表示不存在则创建 session.setAttribute(user, username); session.setMaxInactiveInterval(30 * 60); // 30分钟无操作过期 // 3. 重定向到主页避免重复提交 response.sendRedirect(main.jsp); } else { request.setAttribute(error, 用户名或密码错误); request.getRequestDispatcher(index.jsp).forward(request, response); } } }参数说明request.getSession(true)确保Session存在setMaxInactiveInterval(1800)单位是秒response.sendRedirect()是302重定向地址栏变main.jsp而forward()是服务器端跳转地址栏仍为/login且request属性可传递。对应index.jsp登录表单form actionlogin methodpost 用户名input typetext nameusername requiredbr 密码input typepassword namepassword requiredbr input typesubmit value登录 /form c:if test${not empty error} font colorred${error}/font /c:if注意JSP中${error}能取到是因为forward()时request作用域未销毁若用sendRedirect()则需改用session.setAttribute(error, xxx)并在index.jsp中% session.getAttribute(error) %获取。3.2 成绩录入ScoreServlet的事务控制与SQL注入防御原始源码常这样写String sql INSERT INTO score VALUES(null, studentId , subject , score ); stmt.executeUpdate(sql);——这是SQL注入温床。必须用PreparedStatementWebServlet(/addScore) public class ScoreServlet extends HttpServlet { protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String studentId request.getParameter(studentId); String subject request.getParameter(subject); String scoreStr request.getParameter(score); Connection conn null; PreparedStatement pstmt null; try { Context ctx new InitialContext(); DataSource ds (DataSource) ctx.lookup(java:comp/env/jdbc/StudentDB); conn ds.getConnection(); // 1. 开启事务 conn.setAutoCommit(false); // 2. 使用预编译防止注入 String sql INSERT INTO score(student_id, subject, score) VALUES(?, ?, ?); pstmt conn.prepareStatement(sql); pstmt.setString(1, studentId); pstmt.setString(2, subject); pstmt.setDouble(3, Double.parseDouble(scoreStr)); pstmt.executeUpdate(); // 3. 提交事务 conn.commit(); request.setAttribute(msg, 录入成功); } catch (Exception e) { // 4. 回滚事务 if (conn ! null) { try { conn.rollback(); } catch (SQLException ex) {} } request.setAttribute(msg, 录入失败 e.getMessage()); e.printStackTrace(); } finally { // 5. 关闭资源按pstmt→conn顺序 if (pstmt ! null) try { pstmt.close(); } catch (SQLException e) {} if (conn ! null) try { conn.close(); } catch (SQLException e) {} } request.getRequestDispatcher(score_add.jsp).forward(request, response); } }逻辑说明conn.setAutoCommit(false)关闭自动提交pstmt.setString(1, studentId)将参数绑定到?占位符彻底杜绝SQL注入conn.rollback()在异常时回滚保证数据一致性finally块确保资源释放避免连接泄漏。3.3 成绩查询JSPJSTLEL实现动态表格渲染别再用% while(rs.next()){ out.print(tr...); } %拼HTML用JSTL标签库EL表达式在webapp/WEB-INF/lib/放入jstl-1.2.jar和standard-1.1.2.jarscore_list.jsp中引入标签库并遍历List% taglib prefixc urihttp://java.sun.com/jsp/jstl/core % html headtitle成绩列表/title/head body table border1 trth学号/thth姓名/thth科目/thth成绩/th/tr c:forEach items${scoreList} varscore tr td${score.studentId}/td td${score.studentName}/td td${score.subject}/td td${score.score}/td /tr /c:forEach /table /body /html参数说明c:forEach遍历request.getAttribute(scoreList)Servlet中request.setAttribute(scoreList, list)传入${score.studentId}调用Score实体类的getStudentId()方法JSTL自动处理null值显示空字符串而非null比% score.getStudentId() null ? : score.getStudentId() %简洁百倍。4. 避坑指南那些让90%人调试到凌晨三点的致命细节4.1 现象访问http://localhost:8080/显示404但Tomcat控制台无报错原因IDEA部署时未将webapp目录设为Web资源根路径或web.xml中welcome-file-list指定的index.jsp不存在于webapp/下比如误放在src/main/webapp/子目录。解决右键项目 →Open Module Settings→Facets→Web→ 检查Web Resource Directory是否指向your-project/webapp确认webapp/index.jsp真实存在且文件编码为UTF-8Windows记事本保存时选“UTF-8无BOM”。4.2 现象登录后跳转main.jsp但页面显示HTTP Status 404 – Not Found原因main.jsp中用了% page contentTypetext/html;charsetUTF-8 %但文件本身是GBK编码尤其Windows系统用记事本创建导致JSP编译时中文乱码Tomcat无法识别文件。解决用Notepad或VS Code打开main.jsp右下角查看编码若为ANSI/GBK点击“编码 → 转为UTF-8”并保存同时在web.xml中全局声明编码filter filter-nameCharacterEncodingFilter/filter-name filter-classorg.apache.catalina.filters.SetCharacterEncodingFilter/filter-class init-param param-nameencoding/param-name param-valueUTF-8/param-value /init-param /filter filter-mapping filter-nameCharacterEncodingFilter/filter-name url-pattern/*/url-pattern /filter-mapping4.3 现象MySQL插入中文显示???查库看到乱码原因MySQL服务端、数据库、表、连接URL四层编码未统一为utf8mb4。解决修改MySQL配置文件my.cnfLinux或my.iniWindows[client] default-character-set utf8mb4 [mysqld] character-set-server utf8mb4 collation-server utf8mb4_unicode_ci重启MySQL后执行SQL重建库表CREATE DATABASE studentdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE studentdb; CREATE TABLE score ( id INT PRIMARY KEY AUTO_INCREMENT, student_id VARCHAR(20), subject VARCHAR(50), score DOUBLE ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;JDBC URL追加参数?useUnicodetruecharacterEncodingutf8mb4serverTimezoneGMT%2B84.4 现象c:forEach不生效表格空白控制台无报错原因JSTL JAR包未正确加载或web.xml未声明Servlet 3.1版本导致JSP容器忽略taglib指令。解决检查webapp/WEB-INF/lib/下是否有jstl-1.2.jar非jstl-api-1.2.jar确认web.xml根节点web-app有version3.1属性在JSP顶部强制声明% page isELIgnoredfalse %某些旧Tomcat默认禁用EL。4.5 现象修改JSP后刷新页面无变化仍显示旧内容原因Tomcat的JSP热编译缓存未更新或浏览器强缓存了.jsp响应。解决清空Tomcat工作目录rm -rf tomcat/work/Catalina/localhost/your-app-nameLinux或删除tomcat\work\Catalina\localhost\your-app-nameWindows浏览器按CtrlF5强制刷新在conf/web.xml中全局禁用JSP缓存仅开发用servlet servlet-namejsp/servlet-name servlet-classorg.apache.jasper.servlet.JspServlet/servlet-class init-param param-namedevelopment/param-name param-valuetrue/param-value /init-param /servlet5. 进阶验证用PostmanMySQL命令行交叉验证揪出隐藏Bug5.1 用Postman模拟表单提交绕过JSP前端验证JSP里的required属性只是浏览器校验后端Servlet必须二次验证。用Postman发POST请求直击Servlet测试边界情况测试场景Postman配置预期结果实际验证点空学号提交Body → x-www-form-urlencoded →studentId返回错误提示request.getParameter(studentId)是否为空字符串而非nullSQL注入尝试subject OR 11插入失败或报错查看MySQL日志确认INSERT语句是否含恶意SQL片段成绩超范围score150应拦截并提示“成绩应在0-100之间”Servlet中是否做if(score0技巧在Servlet中加日志输出真实参数System.out.println(Received: studentId studentId , subject subject , score scoreStr);Postman发送后立即看Tomcat控制台输出比断点调试快10倍。5.2 MySQL命令行验证数据一致性别信JSP页面显示JSP页面可能因EL表达式错误、JSTL标签未加载而显示空表格但数据其实已入库。必须直连MySQL验证# 进入MySQL命令行 mysql -u root -p # 选择数据库 USE studentdb; # 查看score表结构确认字段类型 DESCRIBE score; # 查询所有记录验证中文是否正常 SELECT * FROM score; # 检查事务是否生效故意让Servlet抛异常看是否回滚 INSERT INTO score(student_id, subject, score) VALUES(S001, 数学, 95); # 手动开启事务测试 START TRANSACTION; INSERT INTO score(student_id, subject, score) VALUES(S002, 英语, 88); ROLLBACK; -- 执行后S002记录应消失参数说明DESCRIBE score检查student_id是否为VARCHAR非INT避免学号001存成1SELECT *确认subject字段显示“数学”而非“???”ROLLBACK验证事务回滚能力——这是成绩系统的核心保障。5.3 Tomcat线程池压测100并发登录会不会挂教学系统没考虑并发但真实场景下HttpSession和数据库连接池是瓶颈。用abApache Bench简单压测# 模拟100个用户每个用户请求10次登录 ab -n 1000 -c 100 http://localhost:8080/login观察Tomcat控制台若出现SEVERE: All threads (200) are currently busy说明maxThreads不足若MySQL报Too many connections说明连接池maxActive设太小调优方案conf/server.xmlExecutor nametomcatThreadPool namePrefixcatalina-exec- maxThreads200 minSpareThreads25 maxIdleTime60000/ Connector executortomcatThreadPool port8080 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 /血泪经验minSpareThreads设为25避免突发流量时线程创建延迟maxIdleTime6000060秒防止空闲线程长期占用内存压测后务必恢复maxThreads200生产环境按CPU核心数*2设如4核设80。6. 我的三个硬核习惯让这套老技术栈在2024年依然高效可靠6.1 每个Servlet类顶部写明职责与输入输出契约别再让团队新人猜ScoreServlet是增删改查哪个。我在类开头强制写/** * 成绩录入Servlet * 输入参数POST * - studentId: 学号非空长度≤20 * - subject: 科目名称非空长度≤50 * - score: 成绩数字0-100 * 输出 * - 成功跳转score_add.jsprequest.setAttribute(msg,录入成功) * - 失败跳转score_add.jsprequest.setAttribute(msg,错误详情) * 数据库操作INSERT INTO score(student_id, subject, score) */ WebServlet(/addScore) public class ScoreServlet extends HttpServlet { // ... 实现 }为什么有效契约文档化后前端传参不敢乱来测试人员知道该填什么值交接时不用口头解释。我见过太多项目因为studentId传了S001 带空格导致查不到学生就因为没人写清楚“是否trim”。6.2web.xml里所有servlet按字母序排列servlet-mapping严格对应老源码常把LoginServlet映射写在ScoreServlet后面导致/login路径被覆盖。我的做法!-- 按servlet-name字母升序 -- servlet servlet-nameAddScoreServlet/servlet-name servlet-classcom.example.servlet.ScoreServlet/servlet-class /servlet servlet servlet-nameLoginServlet/servlet-name servlet-classcom.example.servlet.LoginServlet/servlet-class /servlet !-- mapping与servlet-name严格一一对应不交叉 -- servlet-mapping servlet-nameAddScoreServlet/servlet-name url-pattern/addScore/url-pattern /servlet-mapping servlet-mapping servlet-nameLoginServlet/servlet-name url-pattern/login/url-pattern /servlet-mapping玄学效果排序后一眼看出URL路径是否重复如两个/logingrep -A 2 login就能定位全部相关配置servlet-mapping紧贴servlet避免复制粘贴时错位。6.3 MySQL建表时每个字段加COMMENT用SHOW CREATE TABLE导出DDL别让score表字段变成谜题。建表时强制写注释CREATE TABLE score ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT 主键ID, student_id VARCHAR(20) NOT NULL COMMENT 学号唯一标识学生, subject VARCHAR(50) NOT NULL COMMENT 科目名称如数学、英语, score DOUBLE NOT NULL COMMENT 成绩0-100之间, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT学生成绩表;然后用SHOW CREATE TABLE score\G导出带注释的建表语句存为score_table.sql。每次部署新环境直接source score_table.sql注释自动同步。后悔药某次线上事故发现student_id被误设为INT导致学号001存成1。有了COMMENTgrep 学号 *.sql三秒定位问题文件没有注释只能翻Git历史逐行diff。这套组合拳下来一个看似陈旧的Java Web项目反而成了最透明、最可控、最容易排查的系统。它不追求时髦但每一步都踩在工程底线之上——连接池防泄漏、PreparedStatement防注入、事务保一致、注释保可读。这些年我带过的实习生凡是能把这套流程走通的三个月后都能独立维护银行核心系统的报表模块。技术会迭代但对数据的责任、对请求的敬畏、对边界的清醒永远不过时。希望帮到你。本文还有配套的精品资源点击获取