企业官网建设流程全解析

简介：面向javaweb初学者的教务管理系统项目源码包，覆盖登录、找回密码、修改密码、注销，以及学生、教师、教务员、系统管理员四类角色的完整业务流程。项目采用MVC设计模式与DAO模式，基于Servlet、JSP、Filter和MySQL数据库构建，适配Tomcat v7.0.84与JDK1.8开发运行环境。压缩包共223个文件，其中82个class编译文件、82个java源码、38个jsp页面占主体，另含jar包、XML配置与SQL脚本，导入Eclipse即可查看分层目录结构，整个资源仅2.6MB，适合快速下载与本地部署，目前已有11656人学习浏览。下载后先读README.txt有助于理解启动方式，再结合代码研读学生成绩查询、选修与考级报名、学籍信息查看修改、教师信息维护、教务员成绩管理、管理员用户管理等模块的实现逻辑。项目保留部分待完善功能，适合初学者在此基础上继续扩展，也可作为课程设计或毕业设计的参考起点。

1. 教务管理系统javaweb项目：为什么老掉牙的JSP+Servlet还是课设首选

如果你在搜索引擎里敲下“教务管理系统javaweb项目”，大概率是被课程设计或者毕业设计逼到这一步了。网上能下载到的项目源码多到能让你挑花眼，可真正能一次跑起来的十个里未必有一个——不是缺数据库脚本，就是JDK版本不对，要么是IDEA里压根配置不好Tomcat。先说一个反直觉的结论：这种“老技术栈”项目最大的坑不在业务逻辑，而在环境与部署。JSP、Servlet、MySQL这套组合虽然被Spring Boot按在地上摩擦了很多年，但它恰恰是课设场景下最不容易翻车的选型：资料多、报错好搜、答辩时老师问到底层你也能答得上来。这篇笔记就沿着“表结构设计 -> IDEA跑通 -> 核心业务落地 -> 常见连环坑”这条线，把整个教务系统的骨架一次讲清。

2. 技术选型与数据库设计：先把表和关系立住

2.1 “老技术”不等于“烂技术”：为什么JSP+Servlet更适合课设

很多同学上来就想用Spring Boot + Vue把教务系统做成前后端分离，觉得这样才“拿得出手”。我的建议是：除非你已经有扎实的Spring Boot项目经验，否则课设选JSP+Servlet反而更容易拿到好分数。原因有三点。

第一，验收环境不确定。答辩用的机器未必装了Node.js、Maven，甚至JDK版本都很随机。传统JavaWeb只要一个Tomcat加一个MySQL就能跑，结构直观，老师检查起来也省事。第二，自己讲得清楚。Servlet生命周期、请求转发与重定向的区别、过滤器原理——这些都是JSP+Servlet项目的核心知识点，也是答辩时被问到概率最高的问题；换成Spring Boot你可能只知道“加个注解就行”，一旦被追问底层就露怯了。第三，资料密度决定排错速度。搜“javaweb项目完整案例mysql”能出来一整页教程，而序列化的前后端分离项目报错时，你连报错在前端还是后端都判断不出来。

所以我的建议是：如果这是你第一个完整项目，老老实实做Servlet+JSP；如果你已经是老手，可以用这个标题练手SSM整合，但没必要在课设里硬上微服务那套。一个能讲清楚原理、跑得顺畅的项目，比一个你复制来的高大全框架更值钱。

2.2 教务系统核心表：五张表撑起一个课设骨架

教务管理系统的业务本质是什么？就是“谁（学生/教师）在什么时间（学期）对什么（课程/成绩）做了什么（选课/录入）”。先别急着写代码，把表结构设计好，后面所有业务都会顺很多。我一般建议至少建五张表：用户表、学生表、教师表、课程表、选课成绩表。这五张表能覆盖登录、个人信息、课程管理、选课、成绩录入这些核心功能。

用户表存登录账号密码，用角色字段区分admin、teacher、student；学生表和教师表存基本信息，通过user_id关联用户表；课程表存课程名称、学分、授课教师；选课成绩表是学生和课程的多对多关联，附带成绩字段。下面是精简版的建表SQL：

CREATE DATABASE edu_system DEFAULT CHARACTER SET utf8mb4; USE edu_system; CREATE TABLE `user` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `username` VARCHAR(50) UNIQUE NOT NULL, `password` VARCHAR(100) NOT NULL, `role` VARCHAR(20) NOT NULL COMMENT 'admin/teacher/student' ); CREATE TABLE `student` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `user_id` INT NOT NULL, `name` VARCHAR(50) NOT NULL, `student_no` VARCHAR(30) UNIQUE NOT NULL COMMENT '学号', `major` VARCHAR(50), FOREIGN KEY (`user_id`) REFERENCES `user`(`id`) ); CREATE TABLE `teacher` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `user_id` INT NOT NULL, `name` VARCHAR(50) NOT NULL, `title` VARCHAR(30) COMMENT '职称', FOREIGN KEY (`user_id`) REFERENCES `user`(`id`) ); CREATE TABLE `course` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `course_no` VARCHAR(30) UNIQUE NOT NULL COMMENT '课程号', `course_name` VARCHAR(100) NOT NULL, `credit` DECIMAL(3,1) NOT NULL COMMENT '学分', `teacher_id` INT NOT NULL, FOREIGN KEY (`teacher_id`) REFERENCES `teacher`(`id`) ); CREATE TABLE `course_selection` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `student_id` INT NOT NULL, `course_id` INT NOT NULL, `score` DECIMAL(5,2) DEFAULT NULL COMMENT '成绩，NULL表示未录入', UNIQUE KEY `uk_stu_course` (`student_id`, `course_id`), FOREIGN KEY (`student_id`) REFERENCES `student`(`id`), FOREIGN KEY (`course_id`) REFERENCES `course`(`id`) );

几个容易被忽略的细节值得多说两句。

第一个是字符集。建库时直接用utf8mb4而不是utf8，否则后面存中文时可能遇到“Incorrect string value”的报错。第二个是course_selection表一定要加联合唯一约束(student_id, course_id)，这是防止同一学生重复选同一门课的数据库层面的最后一道防线，代码里查一次只是第一道。第三个是score字段允许为NULL，它的含义是“还没录成绩”，而不是0分。很多同学习惯给分数默认值0，结果成绩未录入时名单上全是0分，答辩老师一眼就能看出问题。

3. 从IDEA把项目跑起来：Tomcat配置、JDBC连接与三层结构

3.1 IDEA运行javaweb项目配置：第一次启动的完整路径

“代码写好了，启动Tomcat却404”是我收到过最多的求助。搜索热词“idea运行javaweb项目配置”常年居高不下，说明这不是你一个人的问题。这一节按顺序走一遍，每一步都不要跳过。

第一步是准备环境。JDK用8或11都行，Tomcat用8.5到9.0之间的版本——别用Tomcat 10，因为Tomcat 10把javax.servlet包改成了jakarta.servlet，教科书和网上大多数代码都是基于javax写的，你复制一份老代码到Tomcat 10上直接编译不过。IDEA里新建一个Java Enterprise项目，选Web Application模板，然后在Project Structure的Artifacts里确保有war exploded输出。接着配置Tomcat：Run -> Edit Configurations -> 点加号选Tomcat Server -> Local，在Deployment标签页把刚才那个war exploded添加进去，Application context填/edu。

第二步是给Web工程配Servlet映射。现在的Web项目大多用注解@WebServlet，不再需要把每个Servlet都注册到web.xml里。但如果你下载的老项目还用web.xml，就得检查servlet-mapping中的url-pattern是否和浏览器访问路径一致。这里给你一个判断技巧：如果首页能打开但一登录就404，几乎都是Servlet映射路径写错了，浏览器地址栏里实际请求的路径和@WebServlet里的值对不上。如果你用的是注解方式，顺手把web.xml里的<web-app>版本声明设高一点，避免老版本约束限制新写法。

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd" version="4.0"> </web-app>

3.2 DBUtil与三层架构：JDBC连接池参数和第一个查询

工程结构方面，如果标题是“javaweb项目完整案例”，结构没有标准答案，但我建议你按经典的controller（Servlet）、service、dao三层来摆代码，这层结构本身就是答辩加分项。Servlet层只负责接收请求和响应；Service层处理业务规则；Dao层写SQL。别把所有JDBC代码堆在Servlet里，不用等到答辩，你自己维护到第三天就想重写了。

数据库连接用连接池，别再用DriverManager.getConnection()裸连了。常用的是Druid或C3P0，这里以Druid为例，先说配置文件druid.properties，这是整个项目跑不跑得起来的命门之一：

driverClassName=com.mysql.cj.jdbc.Driver url=jdbc:mysql://localhost:3306/edu_system?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=UTF-8 username=root password=你的密码 initialSize=5 maxActive=20

上面三个参数最容易出错，挨个说。driverClassName必须写com.mysql.cj.jdbc.Driver，这是MySQL 8以后的驱动类路径；网上老代码里的com.mysql.jdbc.Driver在MySQL 8里已经废弃了，不换就报ClassNotFoundException。url里的serverTimezone=Asia/Shanghai是必须的，否则MySQL 8会报时区错误；characterEncoding=UTF-8保证读写中文不乱码。password就是你的MySQL密码，别把root账号的密码和项目代码的数据库密码搞混。

然后写一个工具类DBUtil，用Druid的DataSource拿连接：

import com.alibaba.druid.pool.DruidDataSourceFactory; import javax.sql.DataSource; import java.io.InputStream; import java.sql.Connection; import java.sql.SQLException; import java.util.Properties; public class DBUtil { private static DataSource dataSource; static { try (InputStream is = DBUtil.class.getClassLoader() .getResourceAsStream("druid.properties")) { Properties props = new Properties(); props.load(is); dataSource = DruidDataSourceFactory.createDataSource(props); } catch (Exception e) { throw new ExceptionInInitializerError("数据库连接池初始化失败: " + e.getMessage()); } } public static Connection getConnection() throws SQLException { return dataSource.getConnection(); } }

这个工具类的关键点是静态代码块加载配置文件，只会执行一次。如果初始化失败，ExceptionInInitializerError会在类加载时直接抛出来，比运行半个项目后发现凭证连接失败好排查得多。getConnection()每次调用都会从连接池里借一个连接，用完记得关闭——正常做法是在finally块里关，省事点可以直接在Dao层用try-with-resources写法。

4. 核心业务落地：登录控制、选课事务与成绩录入

4.1 登录与会话管理：从session到验证码的完整做法

教务系统的登录不能只查一下用户名密码对不对就完事，至少要考虑三件事：密码要不要加密存储、登录状态用什么保存、验证码要不要做。

密码加密方面，明文存储是答辩时的送命题。老师要是看到数据库里password字段直接写着123456，基本印象分就没了。用MD5加盐的民间做法仍然是课设里性价比最高的一套，虽然现代安全标准推荐BCrypt，但课设阶段讲清楚“加盐哈希”的设计思路就够了。一个可复现的写法是：注册时把用户输入的密码和固定盐拼在一起做MD5，存进数据库；登录验证时同样拼接再比对。

登录状态保存，用HttpSession是Servlet标准里的天然方案。核心逻辑是登录成功后把用户对象塞进session，再设置一个存活时间，之后每次请求通过过滤器拦截Session里有没有用户：

// LoginServlet.java 核心片段 @WebServlet("/login") public class LoginServlet extends HttpServlet { @Override protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { String username = req.getParameter("username"); String password = req.getParameter("password"); String captcha = req.getParameter("captcha"); String sessionCaptcha = (String) req.getSession().getAttribute("captcha"); // 1. 先校验验证码，防止后续无用查询 if (captcha == null || !captcha.equalsIgnoreCase(sessionCaptcha)) { req.setAttribute("error", "验证码错误"); req.getRequestDispatcher("/login.jsp").forward(req, resp); return; } // 2. 校验用户名密码，这里是简化写法 User user = userService.login(username, MD5Util.md5(password)); if (user == null) { req.setAttribute("error", "用户名或密码错误"); req.getRequestDispatcher("/login.jsp").forward(req, resp); return; } // 3. 登录成功后写session，并设置超时时间 HttpSession session = req.getSession(); session.setMaxInactiveInterval(30 * 60); session.setAttribute("loginUser", user); // 4. 按角色跳转到不同首页 if ("admin".equals(user.getRole())) { resp.sendRedirect(req.getContextPath() + "/admin/home"); } else if ("teacher".equals(user.getRole())) { resp.sendRedirect(req.getContextPath() + "/teacher/home"); } else { resp.sendRedirect(req.getContextPath() + "/student/home"); } } }

这段代码里有三个小点容易被忽视。验证码比较用了equalsIgnoreCase，避免用户大小写输错被卡。登录成功后用了sendRedirect而不是forward，是为了防止表单重复提交——刷新页面就重复登录一次。Session超时时间30分钟是委婉的“安全策略”，意思是不用给太长时间不操作的人占着登录态。密码那一行用了工具类做MD5，保证明文密码不会在网络传输甚至日志里裸奔。

4.2 选课与成绩录入：事务边界从哪开始从哪结束

学生选课和教师录成绩这两个功能的共同特点是“写多张表”，这就绕不开事务。如果选课时插入一条选课记录、又要同步更新课程的已选人数，两步之间任何一步失败，数据就处于不一致状态——学生以为选上了，课程的已选人数却没涨。

JDBC里开事务很直接：用同一个Connection对象，先setAutoCommit(false)，多条SQL执行完再commit()，中途任何异常都要rollback()。关键点是“同一个Connection”——很多同学在Dao层里每个方法单独getConnection()，Service层想包事务根本无从谈起。常见做法是Service层获取连接，传给Dao层使用。以选课为例：

public boolean selectCourse(int studentId, int courseId) { Connection conn = null; try { conn = DBUtil.getConnection(); conn.setAutoCommit(false); // 检查是否已选过该课程 CourseSelectionDao csDao = new CourseSelectionDao(); if (csDao.isSelected(conn, studentId, courseId)) { return false; // 已选过，直接返回 } // 插入选课记录 + 更新课程已选人数（示例SQL略） csDao.addSelection(conn, studentId, courseId); CourseDao courseDao = new CourseDao(); courseDao.increaseSelectedCount(conn, courseId); conn.commit(); return true; } catch (Exception e) { try { conn.rollback(); } catch (SQLException ex) { ex.printStackTrace(); } return false; } finally { // 恢复自动提交，连接池复用前要把状态还原 try { conn.setAutoCommit(true); } catch (SQLException e) { e.printStackTrace(); } try { conn.close(); } catch (SQLException e) { e.printStackTrace(); } } }

你以为写完commit就完了，最后那个finally才是真正有经验的人会补的。连接池里的连接是要复用的，你设置了setAutoCommit(false)用完后不还原，下一次拿到这条连接的代码会在同一事务里运行，这属于不查不知道、一查吓一跳的隐性坑。同样，rollback()之后要把autoCommit还原，这是Druid连接池使用规范里经常被忽略的一条。

成绩录入的逻辑更简单，单表更新就行，但要注意录入前校验权限：先确认当前登录用户是这门课的授课教师，否则任何教师都能改任何学生的成绩。核心规则一句话——业务代码不信任前端传的任何参数，Session里的角色判断只能作为第一步过滤，写操作前在Service层再用数据库查一遍归属关系。

4.3 分页查询：Dao层一个SQL加JSP一个标签

教务系统里课程列表、学生名单这些页面都逃不开分页。网上好多项目分页是假分页：一次把所有数据查出来再用Java截取List的一部分。数据量小的时候看不出毛病，但答辩时老师一旦说出“查看第57页”你就尴尬了。真分页的方式就是SQL层面用LIMIT，加上一个COUNT查询出总记录数。

// CourseDao.java 中的分页查询方法 public List<Course> findPage(int offset, int pageSize) throws SQLException { String sql = "SELECT id, course_no, course_name, credit FROM course LIMIT ?, ?"; try (Connection conn = DBUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setInt(1, offset); ps.setInt(2, pageSize); try (ResultSet rs = ps.executeQuery()) { List<Course> list = new ArrayList<>(); while (rs.next()) { Course c = new Course(); c.setId(rs.getInt("id")); c.setCourseNo(rs.getString("course_no")); c.setCourseName(rs.getString("course_name")); c.setCredit(rs.getBigDecimal("credit")); list.add(c); } return list; } } }

配合的JSP页面用JSTL的c:forEach渲染列表，再在页面底部输出上一页下一页链接，URL里带上page参数。页面上用${page.currentPage}这些EL表达式取值。分页的重要参数就是两个：offset = (currentPage - 1) * pageSize和pageSize，别把page直接传给LIMIT的第一个参数。总页码数算出来之后，上一页和下一页的边界要用c:if判断，第一页不显示“上一页”，最后一页不显示“下一页”，否则你会在答辩现场演示点击“下一页”跳到空列表的尴尬局面。

5. 教务系统javaweb项目的六个连环坑：404、中文乱码、连接池超时

以下每一条都是我见过至少两个以上的人踩过的坑，按排查顺序从“项目启动”到“业务逻辑”排列。

5.1 页面404，Tomcat能启动但访问不到Servlet

现象：Tomcat正常启动，访问login.jsp能打开，输入用户名密码提交后浏览器404，地址栏变成了/login。

原因：@WebServlet("/login")注解里的路径和表单提交路径不一致。比如表单action="login.jsp"，Servlet映射在/login，它们根本不是一个东西。另外检查一下页面上表单提交的全路径——如果用了${pageContext.request.contextPath}，要确认Servlet里sendRedirect或forward的路径也带了getContextPath()，否则在多级目录部署时会出现路径错位。

解决：统一用${pageContext.request.contextPath}拼接一切URL，Servlet里的重定向也统一用req.getContextPath()开头。这属于“项目根路径不匹配”的经典问题，与Tomcat启动无关。

5.2 表单提交中文乱码，Tomcat 8以下要单独设编码

现象：输入“张三”，数据库里存的是“å¼ ä¸‰”这种乱码。

原因：Tomcat 8.0及以上版本默认的URI编码是UTF-8，如果你用的Tomcat 7或更低，GET请求的参数需要用URIEncoding="UTF-8"显式声明。POST请求的乱码则是另一个问题，原因是请求体解析时的字符集没指定。

解决：写一个Filter统一处理，把请求和响应的字符集都设为UTF-8：

@WebFilter("/*") public class EncodingFilter implements Filter { @Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { request.setCharacterEncoding("UTF-8"); response.setCharacterEncoding("UTF-8"); response.setContentType("text/html; charset=UTF-8"); chain.doFilter(request, response); } }

加上数据库连接URL里的characterEncoding=UTF-8和表字符集用utf8mb4，这一整套下来中文就畅通无阻了。注意别只设request不设response，那样页面输出的中文仍然是乱码。

5.3 Tomcat启动后报内存溢出：Java heap space

现象：项目部署到Tomcat后，运行一段时间页面访问变慢，后台报java.lang.OutOfMemoryError: Java heap space。

原因：课设项目大部分是变量没释放导致的内存积累，更多是Tomcat默认的堆内存太小。IDEA里跑Tomcat时，默认VM参数并没有给足堆内存。

解决：在IDEA的Run/Debug Configurations里找到Tomcat配置，在VM options栏填入-Xms512m -Xmx512m，如果还不够就加到1G。课设这个体量512M绰绰有余，同时检查是否有没关闭的ResultSet和Statement挤占了内存。这里有个习惯问题：Connection别每次都查一遍代码，ResultSet其实也可能泄漏。

5.4 MySQL 8连接报错：Public Key Retrieval is not allowed

现象：JDBC连接时报Public Key Retrieval is not allowed。

原因：MySQL 8默认的caching_sha2_password认证插件需要客户端获取服务端公钥来加密密码传输，而JDBC驱动默认不自动获取。

解决：在JDBC URL里额外加一个参数allowPublicKeyRetrieval=true。如果用了高版本的MySQL和驱动，还要确认useSSL=false或设为false。这两个参数放在druid.properties的URL末尾，用&连接。

5.5 JSP页面的CSS和JS加载不出来

现象：页面能打开，但样式全乱了，F12看到css文件返回404。

原因：JSP里引用静态资源的路径写成了相对路径，比如href="css/style.css"。在/course/list这种子路径页面里，相对路径会解析成/course/css/style.css，显然找不到。

解决：JSP页面统一用href="${pageContext.request.contextPath}/css/style.css"。如果项目里这种情况到处都有，可以在JSP页面顶部用<c:set>把ctx设为${pageContext.request.contextPath}，然后所有资源引用都写成${ctx}/css/xxx，这是最省事也最不容易漏的写法。

5.6 参数取不到：request.getParameter返回null

现象：页面提交了表单，Servlet里request.getParameter("name")返回null。

原因：表单的name属性和Servlet里获取的key不一致。很多同学被前端框架的id和name搞混，页面元素写了id="username"但没写name="username"，或者写了却和getParameter("username")不一致。名称大小写写错也非常常见。

解决：在Servlet里以打印日志的方式排查关键参数，确认前端到底提交了什么字段名，再决定后端从哪个key取值。排查命令就是System.out.println(req.getParameter("username"))，断点也行。

6. 把项目从“能跑”升级到“能答辩”：防重复提交、操作日志与验收清单

项目跑通只是及格线，“能答辩”是另一套标准。以下几个升级方向，性价比从高到低排序，时间紧的你至少做前两个。

第一个是登录后重定向（Post/Redirect/Get）。这个模式能解决刷新页面时“表单重复提交”的问题，具体做法是：登录成功之后sendRedirect到目标页面，而不是forward转发过去。之前第4章的写法就是用的这个模式。往前再推一步——点击“提交作业”这类写操作按钮时，可以在前端加一个“提交后禁用按钮”的JavaScript，后端在Session里记录一个提交令牌，双保险。这是你答辩时面对“如何防止重复提交经验”这个问题的完美回答。

第二个是操作日志。写一个简单的操作日志表，记录谁在什么时间干了什么事，用一个Filter或者在每个写操作里加一行记录就行。日志表设计不要太繁琐，id, user_id, action, detail, create_time五列足矣。答辩时老师问“系统如何追溯异常操作”，这个表就是最直观的证据。

第三个是补一个Excel导入导出功能。大部分同学都只会手动一条条输入数据，如果你做成“上传一个Excel批量导入学生名单”，亮点就有了。实现上推荐用Apache POI，核心代码就是读Workbook里的每一行，存成Student对象再调Dao层插入。注意批量导入时数据量可能到几百条，必须用事务包住，如果有重复学号要么拒绝导入、要么跳过，给用户一个下载导入失败结果的按钮——这些细节直接决定了你的系统是“能用”还是“好用”。

第四个是异常统一处理。每个Servlet里都try-catch，代码重复不说，还会漏掉一些边界情况。如果你还有余力，写一个BaseServlet，把权限校验、异常处理、日志记录都抽到父类里，子类只负责业务逻辑。老师问到“你这个架构怎么保障代码质量”，你直接把这个父类设计讲一遍，比什么都管用。

最后说一个我自己的教训：课设项目最忌“功能堆砌”。你的系统做完登录、选课、成绩查询之后，不要继续加论坛、问卷、公告板这些边角功能。把一个功能做实做深，比三个功能做浅更有说服力。验收时把核心链路亲手走三遍：学生注册登录选课查成绩、教师开课录入成绩、管理员管理课程与学生名单。跑通这三条，再对着你写的数据库表讲解设计初衷——你就是那个答辩时最有底气的学生。希望这些从环境配置到代码书写的经验能帮到你，不走我当年为了一个404抓耳挠腮两天的弯路。

本文还有配套的精品资源，点击获取