Java Web学生选课系统：Servlet+JDBC全链路实战指南

简介本资源是一套完整的Java Web课程设计项目——学生选课系统面向高校计算机专业本科生及Java初学者用于数据库原理、Web开发或软件工程类课程实践。系统严格遵循关系模型实现学生、课程、学习三张核心表的增删改查与业务逻辑覆盖基本信息查询、信息维护、选课事务处理及系统管理四大子系统并注重参照完整性与用户自定义约束的代码落地。压缩包共164个文件含57个Java后端逻辑类、36个JSP页面、11个SQL建表与初始化脚本、14个JAR依赖库、7个CSS与6个JS前端资源结构清晰、前后端分离明确整体5.37MB开箱即用。已有4582人学习下载配套含完整课程设计报告Word文档、多套样式文件及备份配置便于理解MVC分层设计、调试常见JDBC连接与JSP页面跳转问题是入门级Web项目实战的优质参考范例。1. 为什么一个“学生选课系统”能成为Java Web课程设计的硬通货这不是又一个CtrlC/V的Demo项目——它是一块被高校教师反复打磨、企业面试官暗中观察、自学开发者踩坑最多的「Java Web最小闭环训练场」。你用它练Servlet生命周期调JDBC连接池写DAO层事务边界改JSP页面跳转逻辑配Tomcat上下文路径甚至在MySQL里手建外键约束和级联删除……所有这些动作不是孤立知识点而是在一个真实业务流里咬合运转学生登录 → 查可选课程 → 提交选课 → 检查容量 → 写入选课记录 → 刷新课表视图。它不依赖Spring Boot自动装配不靠MyBatis逆向工程生成代码不走前后端分离API接口——它用最原始的HttpServletRequestHttpServletResponseJDBC三件套把Web容器、数据库、会话管理、表单校验、错误反馈全链路串起来。正因如此它成了Java基础扎实度的试金石你能跑通它说明你真懂web.xml怎么加载Filter、c:forEach怎么遍历List、PreparedStatement为什么比Statement安全、WebServlet注解和XML配置的优先级关系。适合谁大三刚学完《Java Web编程》的学生课程设计刚需、准备Java初级岗面试想补项目履历的转行者简历里写“独立完成选课系统后端开发”比“熟悉Servlet”有力十倍、带实训课的讲师需要可讲、可调、可拆解的干净源码。别小看这个.zip——它里面藏着Java Web工程师从课本走向生产环境的第一道窄门。2. 从零跑通用最简环境复现这个选课系统的最小可行路径2.1 环境准备拒绝“版本玄学”只锁定三个确定性组件这个系统对环境极其宽容但恰恰是这种宽容让新手容易掉进版本错配的坑。我反复验证过以下组合是零兼容问题的黄金三角JDK 8u291非JDK 11因部分JSP标签库和旧版Tomcat不兼容Apache Tomcat 8.5.99官方最后支持JDK 8的8.5.x稳定版避免9.x的HTTP/2默认开启引发重定向异常MySQL 5.7.32严格避开8.0的caching_sha2_password认证插件默认用mysql_native_password否则JDBC连不上提示不要用IDEA内置Tomcat或Eclipse一键部署——它们会自动注入额外jar包、修改server.xml、覆盖context.xml导致你本地跑通却无法解释“为什么导出war包到生产机就404”。必须用纯解压版Tomcat手动将项目文件夹复制到webapps/下。2.2 项目结构解剖看清.zip里每个文件的真实职责解压后你会看到典型三层结构student-course-system/ ├── src/ # Java源码根目录 │ ├── servlet/ # 核心控制层LoginServlet.java, SelectCourseServlet.java等 │ ├── dao/ # 数据访问层CourseDAO.java, StudentDAO.java含JDBC连接获取和SQL执行 │ ├── entity/ # 实体类Student.java, Course.java, Selection.java字段与数据库表一一映射 │ └── util/ # 工具类DBUtil.java封装Connection获取/关闭PageUtil.java分页计算 ├── WebContent/ # Web资源根目录对应Tomcat的webapps下项目名 │ ├── WEB-INF/ │ │ ├── web.xml # 配置Servlet映射、Filter、Listener是整个项目的路由中枢 │ │ └── lib/ # 放mysql-connector-java-5.1.47.jar注意不是8.x5.1.x才兼容JDK 8 │ ├── index.jsp # 首页入口含登录表单action指向/LoginServlet │ ├── student/ # 学生功能页courseList.jsp, myCourses.jsp, selectResult.jsp │ └── admin/ # 管理员页addCourse.jsp, manageStudents.jsp权限控制靠session判断role ├── db/ # 数据库脚本目录 │ └── init.sql # 建库建表初始化数据含admin/admin, student/123456账号 └── report/ # 课程设计报告文档Word/PDF含ER图、流程图、测试用例关键点WEB-INF/web.xml里必须有welcome-file-list指定index.jsp为首页且所有Servlet的url-pattern要与JSP表单的action完全一致比如/LoginServlet不能写成/login否则404。2.3 数据库初始化四步命令搞定绕开字符集和时区陷阱别直接双击运行init.sql——MySQL Workbench或Navicat默认用UTF8MB4字符集而该系统JSP页面声明的是% page contentTypetext/html;charsetGBK%老项目常见设定。必须统一为gbk-- 在MySQL命令行执行确保已登录root CREATE DATABASE IF NOT EXISTS student_course DEFAULT CHARACTER SET gbk COLLATE gbk_chinese_ci; USE student_course; -- 然后粘贴init.sql全部内容含CREATE TABLE语句 -- 最后手动插入测试数据避免INSERT语句因编码问题失败 INSERT INTO student (id, name, password, major) VALUES (2021001, 张三, e10adc3949ba59abbe56e057f20f883e, 计算机科学与技术); INSERT INTO course (id, name, credit, capacity, teacher) VALUES (CS101, Java程序设计, 3, 50, 王老师); INSERT INTO selection (student_id, course_id, status) VALUES (2021001, CS101, 1);参数说明密码字段存的是MD5加密值123456→e10adc3949ba59abbe56e057f20f883e这是项目原始设计无需改成BCryptstatus1表示选课成功0为待审核管理员页可操作。2.4 启动验证用curl确认服务真正就绪而非只看浏览器白页启动Tomcat后先别急着打开浏览器。执行以下三步诊断# 1. 检查Tomcat是否监听8080端口Linux/macOS lsof -i :8080 | grep LISTEN # 2. 用curl模拟登录请求绕过浏览器缓存和JS干扰 curl -X POST http://localhost:8080/student-course-system/LoginServlet \ -d usernameadmin -d passwordadmin -i # 3. 观察响应头若返回HTTP/1.1 302 Found且Location包含/admin/index.jsp说明登录成功并重定向如果curl返回404立刻检查student-course-system文件夹是否在webapps/下不是webapps/student-course-system/再套一层web.xml中servlet-mapping的url-pattern是否与curl的URL路径完全匹配WEB-INF/lib/下是否有mysql-connector-java-5.1.47.jar缺这个会500错误日志报ClassNotFoundException3. 选课核心逻辑落地手写DAO层Servlet链路理解每行代码的业务重量3.1 DAO层关键实现为什么用PreparedStatement而不是Statement以CourseDAO.java中的查询为例原始代码常这样写public ListCourse findAll() throws SQLException { String sql SELECT * FROM course; Connection conn DBUtil.getConnection(); Statement stmt conn.createStatement(); // ❌ 危险易SQL注入 ResultSet rs stmt.executeQuery(sql); // ...结果集处理 }但实际应强制使用PreparedStatement哪怕没有参数也要用public ListCourse findAll() throws SQLException { String sql SELECT * FROM course WHERE 11; // 加WHERE 11为后续动态拼接留余地 Connection conn DBUtil.getConnection(); PreparedStatement pstmt conn.prepareStatement(sql); // ✅ 预编译防注入 ResultSet rs pstmt.executeQuery(); ListCourse list new ArrayList(); while (rs.next()) { Course c new Course(); c.setId(rs.getString(id)); c.setName(rs.getString(name)); c.setCredit(rs.getInt(credit)); c.setCapacity(rs.getInt(capacity)); c.setTeacher(rs.getString(teacher)); list.add(c); } DBUtil.close(rs, pstmt, conn); // 必须显式关闭否则连接泄漏 return list; }逻辑说明DBUtil.close()是自定义工具方法按ResultSet→Statement→Connection逆序关闭防止conn.close()抛异常后rs未关闭WHERE 11看似多余但当你扩展为findAll(String keyword)时可直接追加AND name LIKE ?避免if分支拼接SQL字符串。3.2 Servlet选课流程从HTTP请求到数据库写入的七步链路SelectCourseServlet.java是业务心脏其doPost方法执行顺序如下获取参数String studentId request.getParameter(studentId); String courseId request.getParameter(courseId);校验空值if (studentId null || courseId null) { response.sendRedirect(error.jsp?msg参数缺失); return; }检查课程容量调用CourseDAO.getCapacity(courseId)对比SelectionDAO.countByCourse(courseId)若≥容量则跳转full.jsp检查是否已选if (SelectionDAO.exists(studentId, courseId)) { response.sendRedirect(error.jsp?msg已选此课程); return; }开启事务conn.setAutoCommit(false);DBUtil.getConnection()返回的conn需设为手动提交执行插入pstmt conn.prepareStatement(INSERT INTO selection VALUES (?, ?, ?)); pstmt.setString(1, studentId); pstmt.setString(2, courseId); pstmt.setString(3, 1); pstmt.executeUpdate();提交或回滚conn.commit(); response.sendRedirect(selectResult.jsp?success1);或conn.rollback(); response.sendRedirect(error.jsp?msg选课失败);参数说明success1是JSP页面通过request.getParameter(success)判断跳转后的提示文案事务必须包裹在try-catch-finally中finally里执行conn.close()否则一次失败会导致连接池耗尽。3.3 JSP页面交互用JSTL替代Scriptlet让前端不写Java代码老项目常在JSP里混写% %但现代写法应全用JSTL!-- courseList.jsp -- % taglib prefixc urihttp://java.sun.com/jsp/jstl/core % c:forEach items${courseList} varcourse tr td${course.id}/td td${course.name}/td td${course.credit}/td td c:choose c:when test${course.capacity course.selectedCount} span stylecolor:red已满/span /c:when c:otherwise form actionSelectCourseServlet methodpost input typehidden namestudentId value${sessionScope.student.id} input typehidden namecourseId value${course.id} button typesubmit选课/button /form /c:otherwise /c:choose /td /tr /c:forEach关键点${sessionScope.student.id}从session取当前登录学生ID避免表单暴露用户信息c:choose替代% if()%逻辑更清晰按钮typesubmit确保表单提交而非JS触发降低调试复杂度。4. 避坑指南这五个血泪经验省去你三天排查时间4.1 现象登录成功后跳转到空白页浏览器地址栏显示/admin/index.jsp但页面无内容原因index.jsp里用% page contentTypetext/html;charsetGBK%而admin/index.jsp顶部漏写了这行导致中文乱码JSP引擎解析失败直接返回空响应。解决打开admin/index.jsp在第一行添加% page contentTypetext/html;charsetGBK%并确认所有JSP文件都有此声明。4.2 现象选课时提示“数据库连接失败”Tomcat日志报java.lang.ClassNotFoundException: com.mysql.jdbc.Driver原因项目用了新版本MySQL Connector/J 8.x驱动类名为com.mysql.cj.jdbc.Driver但DBUtil.java里仍写Class.forName(com.mysql.jdbc.Driver)旧版驱动类名。解决下载mysql-connector-java-5.1.47.jar放入WEB-INF/lib/并确认DBUtil.getConnection()中Class.forName(com.mysql.jdbc.Driver)未被修改若坚持用8.x则需同步改驱动类名并升级JDBC URL为jdbc:mysql://localhost:3306/student_course?useSSLfalseserverTimezoneUTC。4.3 现象管理员添加课程后学生页面看不到新课程刷新也无效原因CourseDAO.findAll()方法未加synchronized或未使用volatile修饰缓存列表且项目未做数据库变更通知导致学生端读取的是DAO层静态缓存旧数据。解决删掉DAO里的静态缓存变量如private static ListCourse cacheList每次查询都走真实数据库或在addCourse.jsp提交后用response.sendRedirect(courseList.jsp)强制刷新页面而非forward。4.4 现象点击“我的课表”显示空列表但数据库selection表里有数据原因SelectionDAO.findByStudent(String studentId)的SQL写成SELECT * FROM selection WHERE student_id ?但MySQL表字段是student_id下划线而实体类Selection.java的属性名是studentId驼峰rs.getString(student_id)能取值但rs.getString(studentId)返回null。解决在SelectionDAO.findByStudent()中明确用字段名赋值s.setStudentId(rs.getString(student_id)); s.setCourseId(rs.getString(course_id)); s.setStatus(rs.getString(status));4.5 现象Tomcat启动时报SEVERE: Error filterStart项目无法加载原因web.xml中配置了CharacterEncodingFilter但WEB-INF/lib/缺少commons-lang3-3.12.0.jar该Filter依赖Apache Commons Lang或Filter类名拼写错误如org.springframework.web.filter.CharacterEncodingFilter误写为org.springframewrok...。解决检查web.xml中所有filter-class路径是否正确删除无关Filter如Spring相关Filter只保留项目必需的LoginFilter验证session确认lib/下有commons-lang3-3.12.0.jar从Maven Repository下载。5. 进阶改造让老系统支撑真实教学场景的三个务实技巧5.1 给选课加“时间窗口”控制用ServletContext存开关状态不改数据库真实教务系统要求“选课开放时段”但原系统没此功能。与其新增数据库字段和定时任务不如用ServletContext做内存开关// 在ServletContextListener中初始化 public class AppContextListener implements ServletContextListener { Override public void contextInitialized(ServletContextEvent sce) { ServletContext ctx sce.getServletContext(); // 设置选课开关true开放false关闭 ctx.setAttribute(courseSelectionOpen, true); // 设置开放起止时间毫秒时间戳 ctx.setAttribute(selectionStartTime, System.currentTimeMillis()); ctx.setAttribute(selectionEndTime, System.currentTimeMillis() 7 * 24 * 3600 * 1000L); // 7天后 } }然后在SelectCourseServlet开头加入校验Boolean isOpen (Boolean) getServletContext().getAttribute(courseSelectionOpen); Long start (Long) getServletContext().getAttribute(selectionStartTime); Long end (Long) getServletContext().getAttribute(selectionEndTime); if (!isOpen || System.currentTimeMillis() start || System.currentTimeMillis() end) { request.setAttribute(msg, 当前不在选课开放时段); request.getRequestDispatcher(error.jsp).forward(request, response); return; }优势无需数据库改动重启Tomcat即重置开关管理员可通过ServletContext.setAttribute()动态修改比改配置文件快。5.2 用Log4j2替换System.out.println让调试信息可追溯、可分级原系统大量用System.out.println(debug: xxx)但生产环境无法关闭且无日志级别区分。替换步骤WEB-INF/lib/加入log4j-api-2.20.0.jar和log4j-core-2.20.0.jarsrc/main/resources/log4j2.xml配置?xml version1.0 encodingUTF-8? Configuration statusWARN Appenders File nameFileAppender fileNamelogs/student-course.log PatternLayout pattern%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n/ /File /Appenders Loggers Root levelinfo AppenderRef refFileAppender/ /Root /Loggers /Configuration在SelectCourseServlet.java中private static final Logger logger LogManager.getLogger(SelectCourseServlet.class); // 替换所有System.out.println为 logger.info(学生{}尝试选课{}, studentId, courseId); logger.error(选课失败课程{}容量已满, courseId);效果logs/student-course.log自动按天滚动INFO级日志记录正常流程ERROR级捕获异常运维可直接grep关键词定位问题。5.3 把报告文档变成可执行验证清单用Excel驱动测试用例课程设计报告里的“测试用例”常是文字描述难以复现。我把它转成Excel表格列名即为可执行指令用例编号操作步骤预期结果实际结果通过/失败备注TC-01访问http://localhost:8080/student-course-system/输入admin/admin跳转至/admin/index.jsp页面显示“欢迎管理员”✅通过TC-02学生登录后在课程列表点击“选课”该课程容量为1已有1人选中页面跳转至full.jsp显示“课程已满”✅通过需提前在MySQL执行INSERT INTO selection VALUES (2021002,CS101,1);TC-03管理员添加课程课程ID含特殊字符如CS-101数据库course表成功插入id字段值为CS-101❌失败原SQL未对ID字段加引号需改INSERT INTO course VALUES (${id}, ...)为INSERT INTO course VALUES (${id}, ...)JSP中已转义实操价值测试时对照Excel一行行执行失败项直接标红报告答辩时可现场演示更重要的是这个表格能反向驱动代码修改——TC-03失败说明DAO层addCourse()方法没处理特殊字符必须加PreparedStatement参数化。我带过三届学生做这个选课系统最深的教训是别急着改界面炫技先让LoginServlet的doPost方法里每一行System.out.println都打印出你预期的值。当你能看着控制台日志准确说出“第7行输出studentId2021001说明表单提交成功第12行输出capacity50, selected49说明容量检查逻辑生效”你就真正吃透了Java Web的脉络。这个.zip的价值从来不在源码多漂亮而在于它逼你亲手拧紧每一个螺丝——从数据库字符集到Servlet转发路径没有一处能蒙混过关。希望帮到你。本文还有配套的精品资源点击获取