基于JavaWeb的作业管理网站：JSP+Servlet+Druid实现与部署

简介：《基于JavaWeb的作业管理网站源码（课程设计）》是一份面向高校计算机相关专业课程设计与毕业设计的JavaWeb项目源码，适用于需要完成作业管理、在线提交、信息发布等场景的学生与开发者。项目包含完整的前后端代码，涉及JSP页面、Servlet/Java业务逻辑、CSS/JS前端样式与交互、数据库配置等典型Web开发模块，可帮助学习者理解JavaWeb项目的基本分层结构。压缩包内共54个文件，主要类型包括Java源文件、JSP页面、jar依赖库、CSS/JS样式脚本以及项目配置文件等，整体大小约7.73MB，结构清晰，便于导入IDE运行与二次开发。项目为作者个人毕设作品，答辩评分95分，代码经过调试验证，可直接运行使用；对于初学者可作为完整项目范例，对于进阶者也可参考其实现思路进行功能扩展。目前已有237人浏览学习，具备较好的参考价值。

1. 基于JavaWeb的作业管理网站：五张核心JSP如何撑起一个答辩95分的课程设计

一套答辩拿到95分的JavaWeb课程设计，拆开源码看，没有Spring，没有MyBatis，就是JSP+Servlet+Druid连接池，外加登录、发布、提交、收集、列表这五张核心JSP。它看起来不大，却把作业管理最常被问到的四条链路全部走通：谁能登录、作业怎么发、学生怎么交、老师怎么统计。很多同学把“作业管理网站”想复杂了，实际上答辩老师更在意完整度，能不能上传文件、能不能在收集页看到谁交了谁没交，比技术栈新不新更重要。这套基于JavaWeb的作业管理网站源码适合正在做课程设计、期末大作业或毕设起步的学生，也适合想补一个完整JavaWeb项目案例的从业者。下面从zip里的文件结构拆起，一路讲到部署步骤、核心逻辑、高频坑和改造方向。

2. 先拆目录再选环境：这份源码适合怎样的JDK、数据库与Tomcat组合

2.1 zip包里的文件逐项说明

打开zip，第一眼看到的是src、druid.properties、web目录。src下按com.gdes.web分包，是整个项目的Java源码，Servlet、Dao、工具类都在这层。web目录下是JSP页面，登录、发布、提交、收集、个人信息都在这里。WEB-INF里放着web.xml和lib，lib目录是项目运行需要的依赖jar包，Druid连接池、MySQL驱动、JSTL这些都在里面。

META-INF目录下只有MANIFEST.MF，这个基本可以忽略，它是打包时的清单描述，课程设计项目里很少手动改它。images里的touxiang.jpg多半是默认头像，个人信息页面会用到。

外部还带了一套bootstrap-4.3.1-dist和一个jquery-3.2.1.min.js，对应前端的两层基石：Bootstrap负责表格、按钮、表单的样式布局，jQuery负责页面里联动交互，比如切换tab、点击后的状态变化。这个组合在课程设计里非常主流，好处是不需要配前端构建工具，JSP里直接引路径就能用，答辩演示时视觉上也不寒酸。

2.2 版本选型：为什么JDK 8 + Tomcat 8.5 + MySQL 5.7最稳妥

这个项目没有pom.xml，不是Maven工程，所以依赖全靠WEB-INF/lib里的jar包。你不需要联网重新找依赖，只要导入时保证lib目录被正确关联就行。版本配置上，我一般建议按这个组合走：JDK 8、Tomcat 8.5、MySQL 5.7。这个组合和网上大量教程视频的匹配度最高，你照着搜“idea运行javaweb项目配置”基本都能对上。

如果你本机已经装了MySQL 8.0，也不是不能用，但jdbc连接url里必须带serverTimezone参数，否则连接层直接报时区错误。Tomcat尽量不要用10以上的版本，10开始是Jakarta EE命名空间，javax.servlet包全换成了jakarta.servlet，这类老Web项目会踩一堆ClassNotFound。同理，JDK 11以上跑非Maven老项目不是不行，但模块化系统可能对lib目录下的部分jar产生访问限制，不如JDK 8省心。

2.3 IDEA里导入非Maven项目的完整方式

这类zip解压后直接在IDEA里Open就行，不要选New Project。看似简单，实际有几个关键配置漏掉就启动不了。常见做法是这样一步步走：

先File→Open选中解压后的根目录，IDEA会识别成普通Java项目。然后打开Project Structure，把Project SDK设成JDK 8，Language Level选8。Modules面板里把src标记为Sources，把web目录标记为Web Resources，这一步很关键，漏掉的话IDEA不会把web.xml和JSP识别成Web工程。

再切到Artifacts，设置类型为Web Application Exploded，把src编译输出和WEB-INF/lib下的依赖都加进去。最后把lib目录添加到Libraries，这样Java源文件里import javax.servlet、com.alibaba.druid才能编译通过。全部配完，Run Configuration里才有Tomcat Server可选项。

提示：Artifacts里不勾选“Include in project build”的话，改了Java代码不会自动重编译，网页上永远跑的是旧class，查错时最容易懵。

如果本机是Eclipse，处理方式也类似：导入时选择Existing Projects into Workspace，然后去Project Facets里勾上Dynamic Web Module，再把lib目录加到Deployment Assembly。IDEA和Eclipse的差异只在导入入口，后面核对源码根目录和依赖目录的思路完全一致。

3. 从zip到可运行：建库、配置Druid与部署启动的全过程

3.1 先准备数据库：建库建表与初始账号

运行项目前必须把MySQL准备好。项目里druid.properties会指向一个数据库，建议统一建一个homework_manage库。源码包里如果带了.sql文件就直接导入，没有的话手动执行下面这份基础脚本：

CREATE DATABASE IF NOT EXISTS homework_manage DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE homework_manage; CREATE TABLE t_user ( id INT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, realname VARCHAR(50) DEFAULT '', role TINYINT NOT NULL DEFAULT 0 COMMENT '0-学生，1-教师', create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE t_homework ( id INT AUTO_INCREMENT PRIMARY KEY, title VARCHAR(200) NOT NULL, content TEXT, deadline DATETIME NOT NULL, teacher_id INT NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE t_submit ( id INT AUTO_INCREMENT PRIMARY KEY, homework_id INT NOT NULL, student_id INT NOT NULL, file_path VARCHAR(255) DEFAULT '', submit_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

逻辑说明：t_user用role字段区分教师和学生，省去两张用户表，课程设计阶段完全够用，后续要加学生班级或教师工号只需要在这个表上补字段。t_homework记录作业内容和截止时间，t_submit记录每一次提交。注意t_submit里不需要设计status字段，因为“已交、未交、迟交”应该由页面根据submit_time和deadline动态算出来，而不是写死在表里，这个逻辑第4章会详细说。

参数说明：deadline用DATETIME类型，因为JSP里传过来的时间格式通常是yyyy-MM-dd HH:mm:ss，DATETIME可以不带转换直接写入，省去SimpleDateFormat解析这一层麻烦。file_path字段建议存服务端保存后的相对路径而不是原始文件名，因为收集页面要跳转到下载地址，存相对路径更容易拼出完整URL。

初始化账号时，先看一下登录的Servlet里有没有MD5工具类。如果源码里做了MD5加密，那就要把密码存成加密后的值，否则登录对不上；如果源码是明文比对，直接存原文就行。这一步决定登录能否一次通过，动手前花两分钟定位登录Servlet很值。

3.2 druid.properties逐参数改写

数据库建好，下一步改连接配置。找到项目根目录的druid.properties，用IDEA打开之后长这样：

driverClassName=com.mysql.jdbc.Driver url=jdbc:mysql://localhost:3306/homework_manage?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username=root password=你的数据库密码 initialSize=5 maxActive=20 maxWait=3000

逻辑说明：driverClassName指向JDBC驱动类，这个值一般不用改，除非lib里的MySQL驱动换成8.x后驱动类名变化。重点改的是url和password。url里useUnicode=true配合characterEncoding=utf8，是数据库连接层中文不乱码的第一道保险。useSSL=false是因为本地开发MySQL默认不开SSL，加它只是省掉一堆WARN日志。serverTimezone=Asia/Shanghai是MySQL 8.0的必填项，MySQL 5.7可以省略，但写上也不影响。

参数说明：initialSize表示连接池初始连接数，maxActive是最大活跃连接数，maxWait是获取连接的超时时间。课程设计这种并发量，initialSize=5、maxActive=20绰绰有余，不建议调大。连接池开得越大，启动时建立物理连接的数量就越多，一旦数据库没起来，报错反而更慢。

改完后不要用系统记事本另存为带BOM的UTF-8，Druid解析properties对BOM敏感，会在第一个key前面解析出\ufeff导致driverClassName找不到。IDEA里默认UTF-8保存即可。

3.3 部署到Tomcat：Run Configuration怎么配

数据库和连接池就绪后，配Tomcat运行。在IDEA右上角Add Configuration，选Tomcat Server → Local，然后进Deployment页签。这里点加号，选Artifact，把刚才配置好的Web exploded包加进去。Application context建议改成/homework，不要留空格或超长路径，后面打开页面会方便很多。

第一次启动如果没配置好JMX端口，IDEA可能弹框提示端口占用，直接确认换一个新端口就行。配好后点运行，控制台出现“Server startup”相关日志，Tomcat就起来了。

浏览器访问http://localhost:8080/homework/login.jsp，页面能打开就算部署成功。到这里项目已经能跑了，接下来要理解它内部怎么流转，才能应付答辩追问和后续改造。

注意：Tomcat默认端口8080，这个端口特别容易被其他开发工具占用。启动日志里一旦出现Address already in use，处理方法放到第5章专门说。

4. 核心功能链路：登录、发布、提交、收集四段流程怎么流转

4.1 登录与Session：整个网站的访问门槛

index.jsp在项目里一般不做主页，它通常是一段重定向或欢迎页，真正的登录入口是login.jsp。表单里提交username和password，交给登录的Servlet处理。我见过不少课程设计把登录逻辑直接写在JSP的scriptlet里，这个项目放在com.gdes.web包里，已经走了Servlet分层，答辩结构分不会低。

典型的登录校验逻辑是这个样子，具体类名打开源码包就能看到：

request.setCharacterEncoding("UTF-8"); String username = request.getParameter("username"); String password = request.getParameter("password"); try (Connection conn = DruidUtils.getConnection(); PreparedStatement ps = conn.prepareStatement( "SELECT * FROM t_user WHERE username=? AND password=?")) { ps.setString(1, username); ps.setString(2, password); try (ResultSet rs = ps.executeQuery()) { if (rs.next()) { HttpSession session = request.getSession(); session.setAttribute("loginUser", username); session.setAttribute("role", rs.getInt("role")); response.sendRedirect("work.jsp"); } else { request.setAttribute("error", "用户名或密码错误"); request.getRequestDispatcher("login.jsp").forward(request, response); } } }

逻辑说明：登录成功后把用户信息放进session而不是request里，这是关键选择。request在一次转发后就失效了，session能跨多个页面保持，后续每个JSP都能通过session判断是否登录。role字段也必须进session，因为发布作业只有教师角色能进，学生访问issue.jsp时要拦截回列表页。

参数说明：PreparedStatement占位符从1开始编号，setString的索引和SQL里?出现的顺序强绑定，一旦后面调整SQL字段顺序，这里必须同步改，否则运行时报Parameter index out of range。如果觉得这样写容易错，项目里用Druid自带的QueryRunner写会更省心。

页面侧还要补一个过滤器，把未登录用户挡在login.jsp外。常见做法是写一个AuthFilter，在doFilter里判断session是否为空，为空就重定向到login.jsp，同时放行login.jsp本身和静态资源，避免死循环。这个过滤器不加的话，直接访问work.jsp就能绕过登录，答辩被问到权限控制会很难看。

4.2 作业发布：issue.jsp的数据怎么落到数据库

issue.jsp是教师端的发布页面，表单字段通常有作业标题、作业内容、截止时间三项。表单提交给发布作业的Servlet，内部就是一次INSERT：把session里的教师id作为teacher_id写入，截止时间字符串直接放进DATETIME字段。

写入之后有个关键动作：要用sendRedirect跳回作业列表页，而不是forward转发。原因是浏览器按F5刷新时，forward会让同一个Servlet再次执行INSERT，导致重复发布；redirect之后页面URL已经变成列表页，刷新只是重查列表，不会重复写库。这个F5重复提交的坑在答辩里被问到的概率很高，值得提前知道。

发布这块还要注意事务。如果除了插入t_homework之外，还涉及其他表的联动写入，比如同时给所有学生生成一条待提交标记，那就应该在同一个Service方法里用Connection事务包住，中途任何一步失败都要rollback。只插一张表的情况下，单条INSERT本身具备原子性，不需要额外手动事务。

4.3 提交作业与文件上传：multipart/form-data是第一个坑

submit.jsp是学生端的核心页面。上传文件必须把form的enctype设置成multipart/form-data，否则request.getParameter拿不到表单字段，getPart也拿不到文件。页面写法大致是：

<form action="submitHomework" method="post" enctype="multipart/form-data"> <input type="hidden" name="homeworkId" value="<%= request.getParameter("id") %>"> <input type="file" name="file" class="form-control-file"> <button type="submit" class="btn btn-primary">提交作业</button> </form>

Part part = request.getPart("file"); String fileName = Paths.get(part.getSubmittedFileName()).getFileName().toString(); String savePath = "D:/upload/" + fileName; part.write(savePath);

逻辑说明：Servlet 3.0以上用Part接口就能拿文件，不需要再引commons-fileupload。文件名必须用Paths.get重新取一次，因为IE浏览器提交的fileName会带上客户端完整路径，不截取最后一段，存下来的文件名就是错的，而且可能包含非法字符。savePath建议用绝对路径，课程设计阶段不要用相对路径，Tomcat工作目录一变，相对路径就解析不到，part.write直接抛IOException。

参数说明：homeworkId通过hidden域传递，这是列表页到提交页之间最直接的数据传递方式。注意这个hidden域必须在form里，而且要放在input标签中，很多同学放在form外面，结果Servlet永远收不到homeworkId，submit记录里作业ID全是0。

上传成功之后，t_submit表里落一条记录，file_path指向服务端保存路径。如果同一份作业允许重复提交，update要比insert合适，按homework_id和student_id查一下，存在就更新文件路径和提交时间，不存在才插入。课程设计里把这个判断逻辑说清楚，是一个不错的加分项。

4.4 收集作业与统计：已交、未交、迟交是怎么算出来的

gather.jsp接收作业id参数，按作业查t_submit表，再关联t_user表把提交人和提交时间列出来。常见实现是两条SQL：一条查作业基本信息拿deadline，一条查提交记录列表。然后在Java代码里遍历提交记录，逐条判断状态。

List<SubmitRecord> records = submitDao.listByHomework(homeworkId); for (SubmitRecord r : records) { if (r.getSubmitTime() == null) { r.setStatus("未交"); } else if (r.getSubmitTime().after(homework.getDeadline())) { r.setStatus("迟交"); } else { r.setStatus("已交"); } }

逻辑说明：状态一定要动态算，不要在插入提交记录时就算好写库。教师可能调整截止时间，动态计算的结果会随查询实时变化，静态写库的状态很快就会和deadline对不上。把已交、迟交、未交三种状态放在内存里判断，不额外消耗数据库资源，代码也直白。

展示上，Bootstrap 4的表格很适合做收集页。状态列用badge标签区分颜色，已交绿色、迟交橙色、未交红色，答辩演示时老师一眼就能看到统计效果。如果还需要一个已交人数汇总，直接在Servlet里for循环计数，比再写一条count查询更快，也少一次数据库交互。

5. 避坑指南：数据库连接、中文乱码、端口占用、上传路径四类高频问题

5.1 数据库连不上：报错信息怎么读

现象：Tomcat启动正常，但登录或访问列表页时报SQLException，常见的有三种：Access denied for user、Unknown database、Communications link failure。

原因：Access denied是druid.properties里用户名或密码不对；Unknown database是url里的库名没建；Communications link failure多半是MySQL服务没启动，或者url里主机端口不对。

解决：先到cmd里执行mysql -uroot -p，确认MySQL能进。能进就检查url末尾斜杠后面的库名，再逐字核对properties里的username和password。数据库服务没启动的话，在Windows服务管理里找到MySQL服务并启动。如果用的是MySQL 8.0，顺带检查url里有没有serverTimezone参数，没有就补上Asia/Shanghai，重启一次项目再试。

5.2 中文乱码：源头有三个

现象：登录后页面中文变成问号，或者数据库里存进去的中文全是??。

原因：三个环节任一编码不一致就会乱码：JSP页面本身不是UTF-8、数据库连接url没带characterEncoding=utf8、MySQL表不是utf8mb4。

解决：JSP页面检查第一行有没有page contentType="text/html;charset=UTF-8" language="java"，没有就补上。druid.properties的url里确认有characterEncoding=utf8。数据库侧执行SHOW CREATE TABLE t_user\G，看到DEFAULT CHARSET不是utf8mb4的话，把表和字段改成utf8mb4再重建数据。三个环节统一后中文基本不会再出问题，这个排查顺序不要反，先页面再连接最后看表结构，能省不少时间。

5.3 端口占用：8080被其他程序抢了

现象：Tomcat启动日志出现Address already in use: JVM_Bind:8080，IDEA控制台直接提示端口被占用，页面打不开。

原因：本地某个进程占了8080，可能是另一个Tomcat实例、Web服务或者开发工具的调试端口。

解决：cmd执行netstat -ano | findstr 8080，最后一列是占用进程的PID，再用tasklist | findstr PID查到具体进程名，确认不是系统关键进程后结束任务。如果这个端口确实被其他项目占着不想关，可以打开IDEA的Run Configuration，把Tomcat的HTTP port改成8081，访问路径同步换成新端口，问题同样解决。

5.4 上传文件报路径错误：FileNotFoundException或下载404

现象：点提交作业时控制台报java.io.IOException，或者上传成功但收集页点下载链接404。

原因：savePath写的是相对路径，比如upload/加文件名。Tomcat运行的工作目录和源代码目录不一致，相对路径解析出来的物理位置根本不存在，part.write就报错。下载侧如果用getRealPath拼路径，也会因为文件不在部署目录内而404。

解决：把上传目录换成固定的绝对路径，比如D:/upload/，并提前建好文件夹。下载可以写一个DownloadServlet，从配置文件读存储目录，通过response输出流把文件写给浏览器。这样上传下载两侧都脱离Tomcat工作目录的影响，改动量小，问题一次解决。

5.5 lib目录失效导致ClassNotFoundException

现象：项目编译不报错，启动后报java.lang.ClassNotFoundException，找不到com.alibaba.druid.pool.DruidDataSource或者com.mysql.jdbc.Driver。

原因：IDEA里lib目录没有被标记成Libraries，Tomcat打包运行时没把jar包带进WEB-INF/lib。

解决：回到Project Structure的Libraries，把WEB-INF/lib的父目录加进去，然后在Artifacts的输出里确认lib被打进部署包。检查方法很简单：启动后到IDEA的Tomcat部署目录看一眼，WEB-INF/lib下有没有那几个jar文件。没有的话，把Artifacts里的lib目录重新加一次再启动。

这一类报错排查时，日志位置也要分清。Tomcat在IDEA里输出的日志分catalina和localhost两类，连接池和驱动加载失败一般在catalina开头，Web应用初始化异常看localhost开头的日志。按日志分层定位，比无脑翻整屏输出快得多。

6. 把课程设计往毕设方向改：三个不重写也能落地的改造点

你有没有这种体会：课程设计拿到高分，但放到简历上自己都觉得单薄。没关系，这套源码的扩展空间其实不错，底层是JSP+Servlet+Druid，结构简单清晰，从它往毕设方向改不需要推倒重来。

第一个改造点是补成绩与评语表。t_submit目前只记录了文件路径，你可以在旁边加一张t_grade表，字段放homework_id、student_id、score、comment、teacher_id。教师在gather.jsp看到提交列表后点进去打分，学生端在work.jsp或个人信息页里查到分数。这个改动正好补上作业管理系统里最缺的闭环，答辩展示时，发布、提交、批改、查询这条完整业务线比单薄的增删改查有说服力得多。

第二个改造点是做一次分层整理。现阶段的com.gdes.web包里可能把Servlet、Dao、工具类混在一起，你可以把连接获取抽到DruidUtils，把每张表的增删改查抽到对应Dao，再把“判断迟交”“统计已交人数”这类业务判断移到Service层。这个纯代码层面的整理不需要学新框架，但最后画架构图时层次非常清晰，论文里也好写。答辩老师问“你这个项目怎么分层”，你能直接给出表现层、业务层、数据层三段链路，印象分会明显不一样。

第三个改造点是前端换皮。现有页面基于Bootstrap 4.3.1和jQuery 3.2.1，视觉效果中规中矩。如果想整体变更强，保留这套后端接口，只把login.jsp、work.jsp、gather.jsp几个页面的HTML重构成Vue或者layui，工作量可控，视觉上完全像两个项目。注意替换时保留form里name属性与后端参数名的对应关系，这是换皮翻车的高发点，后端收不到参数比页面丑更让人头疼。

我自己做课程设计时最吃亏的就是拿个项目先跑功能，数据库和路径全凭感觉，结果一半时间耗在“为什么连不上”“为什么乱码”上。从那以后我每次拿到JavaWeb项目，都强制自己先建库、再改配置、最后才碰代码，按这个顺序走一遍，比看两遍教程都记得牢。希望这次拆解能帮你把这个作业管理网站真正跑起来，也少踩几个我当年踩过的坑。

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