简介面向Java Web课程设计或毕业设计的教学网站完整源码对应“基于WEB操作系统课程教学网站”课题主要为计算机专业学生提供一个可复用、可运行的在线教学平台实现方案。压缩包共502个文件体积约8.57MB主要含有JSP页面、Java源文件、Class字节码、DB数据库脚本及CSS/JS/HTML前端资源同时保留大量BAK备份文件、GIF/JPG课件图片与Doc/Txt开发说明整体覆盖展示层、控制层、数据层和部署文档目录结构清晰适合对照学习。当前已有38人浏览/学习可结合源码与说明文档快速搭建系统。系统实现了课程讲义、视频教程、在线测试、答疑、作业提交、成绩查询等核心模块其中成绩管理支持录入、修改、查询与统计分析展现出较完整的教学业务逻辑项目说明与开发文档补充了系统架构、功能模块和使用方法便于理解JSP与Java交互、数据库表设计及请求处理流程也能直接支撑毕业设计答辩或后续二次开发。1. 别把它当成一个“课件下载站”:操作系统课程教学网站源码解决了什么拿到一份 java 毕业设计源码很多人第一反应是打开页面截图看 UI但真正决定这套课设能不能过答辩的是“课件、作业、测验”这三条业务线有没有闭环。这个基于 WEB 的操作系统课程教学网站不是简单放几个 PPT 链接的静态页它把课程资源管理、作业布置与提交、在线测验自动判分、后台用户管理全部做进了一个 Spring Boot 项目里。学生、教师、管理员三种角色各有一套操作入口。如果你正在找 Java 毕业设计、课程设计源码或者想从一份完整项目里学分层架构和权限控制这份代码值得拿来跑一遍再改。2. 整体架构与技术选型:Spring Boot MyBatis JSP 的分层设计2.1 技术栈:为什么这套组合适合毕业设计这个网站的代码结构是典型的单体应用Spring Boot 做基础框架MyBatis 做数据访问MySQL 存业务数据View 层用 JSP 加 Bootstrap 渲染。没有拆前端工程也没上微服务这在课程设计里反而是优点——答辩时候能一条链路讲清楚请求怎么从页面到数据库再返回页面不用跟老师解释跨域、网关、服务注册这些额外概念。三层架构划分很明确Controller 层只接收参数和做简单校验Service 层处理业务规则Mapper 层通过 XML 和数据库打交道。实体类放在 entity 包下和数据库表字段一一对应。以“上传课件”这个操作为例Controller 收到 MultipartFile 后交给 Service 记录文件元数据Mapper 再把它插进 course_resource 表每一步都能单独断点调试。对刚接触课设源码的同学来说这套组合最大的好处是资料多踩坑记录多。遇到 MyBatis 映射报错、JSP 标签不解析这类问题网上一搜基本都有答案。而且项目打包产物小普通笔记本跑起来不费劲。2.2 目录结构:拿到源码先看哪几个包解压之后你会看到标准的 Maven 工程下面这个目录结构基本就是源码的主干course-teaching-website ├── pom.xml ├── src/main │ ├── java/com/example/coursewebsite │ │ ├── controller # 页面跳转和接口入口 │ │ ├── service # 业务逻辑 │ │ ├── mapper # MyBatis 数据访问接口 │ │ ├── entity # 数据库实体 │ │ ├── interceptor # 登录拦截器 │ │ └── config # 配置类、拦截器注册 │ ├── resources │ │ ├── application.yml # 主配置文件 │ │ ├── mapper # MyBatis 的 XML 映射文件 │ │ └── db # 初始化 SQL 脚本 │ └── webapp/WEB-INF/jsp │ ├── admin # 管理员页面 │ ├── teacher # 教师页面 │ ├── student # 学生页面 │ └── common # 登录、注册、公共组件 └── README.md拿到手不要先从页面翻起先看三个地方application.yml 里数据库配置能不能对得上、db 目录下的 SQL 脚本有没有完整建表语句、controller 包下接口的 RequestMapping 是否符合角色路径。这三个地方确认完毕项目八成能跑起来。resources/mapper 目录存放着每个 Mapper 接口对应的 XML里面写的是真正的 SQL。课设项目里 SQL 往往不长但联表查询和统计语句值得仔细看比如“查询某作业还没提交的学生”用 NOT IN 还是 LEFT JOIN两种写法在数据量大的时候性能差异很明显。2.3 数据库设计:围绕教学闭环的核心表整个业务围绕课程展开主要表大致是下面这些表名作用关键字段user管理员、教师、学生统一用户表username、password、rolecourse课程信息包含课程名和归属教师name、teacher_id、chaptercourse_resource课程课件、实验指导书等资源course_id、file_path、file_sizehomework作业布置信息course_id、title、deadlinehomework_submit学生提交的作业记录homework_id、student_id、status、scorequiz在线测验基本信息course_id、title、start_time、end_timequiz_question测验题目和参考答案quiz_id、question_type、correct_answernotice课程公告title、content、create_timediscussion课程讨论区course_id、user_id、content、reply_touser 和 course 是基础表几乎所有功能都跟这两张表关联。作业表与提交表分开设计是我比较推荐的做法作业本身只存「布置了什么」提交记录才存「谁交了、分数多少」这样同一个学生多次提交或者补交时保留历史记录教师批改也只是更新提交表的 score 和 status不影响作业定义。题目表把参考答案直接放在 quiz_question 表里虽然简单粗暴但自动判分时只需要遍历题目集合逐一比对不用做复杂的答案匹配逻辑。如果课程设计需要展示「难度系数」加一列就行。数据库脚本在 resources/db 下导入时会自动建库建表后面第 4 章会讲具体操作。2.4 配置文件:先改端口、数据库、上传路径这三处Spring Boot 的配置集中在 application.yml最常见的本地运行配置如下server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/course_website?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: root servlet: multipart: max-file-size: 20MB max-request-size: 100MB mvc: view: prefix: /WEB-INF/jsp/ suffix: .jsp mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.coursewebsite.entity upload: path: /data/course-website/upload连接串里的 serverTimezoneAsia/Shanghai 不能省MySQL 8.0 驱动对时区要求严格少了它会抛 SQLException。max-file-size 默认只有 1MB课件 PPT 动辄几十 MB不改这个值一定会翻车。upload.path 是文件落盘的根目录记得改成你自己机器上的一个绝对路径否则上传接口可能因为没有写权限而失败。这里还有一个细节JSP 和 Spring Boot 默认的静态资源目录不同所以必须通过 spring.mvc.view.prefix 和 suffix 把视图解析指到 /WEB-INF/jsp。如果你打算打 war 包部署到外部容器还要在 pom.xml 里改 packaging 为 war这些放到第 4 章一起说。3. 核心模块拆解:登录、上传、作业、测验的代码链路3.1 登录认证与拦截器:Session 方案在课设里的性价比网站把用户分成学生、教师、管理员页面上直接体现为不同角色的首页菜单。权限控制没有引入 Spring Security而是用拦截器加 Session这在毕业设计里很常见逻辑直观答辩也容易解释。核心拦截器代码大致这样public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String uri request.getRequestURI(); if (uri.startsWith(/login) || uri.startsWith(/register) || uri.startsWith(/css) || uri.startsWith(/js) || uri.startsWith(/images)) { return true; } HttpSession session request.getSession(); User user (User) session.getAttribute(user); if (user null) { response.sendRedirect(request.getContextPath() /login); return false; } request.setAttribute(loginUser, user); return true; } }这段代码做了两件事放行登录注册和静态资源其余请求一律检查 Session 里有没有 user。查到用户就把它塞到 request 属性里后续 Controller 和 JSP 页面直接用 loginUser 读取当前用户。没有登录的统一重定向到登录页避免出现「直接访问 /teacher/home 越权」的情况。角色细粒度控制我一般不放拦截器而是在各个 Controller 方法里判断 user.getRole()比如教师管理页面只允许 role 等于 teacher 或 admin 的请求通过。原因是课设项目角色少写一个通用注解成本反而高不如在每个关键接口前面加一行判断清晰。拦截器注册到 WebMvcConfigurer 的 addInterceptors 方法里注意排除路径一定要写上静态资源否则 CSS 全部加载不出来。3.2 课件资源的上传与下载:本地磁盘存储课程资源是整个网站的核心数据包括教学课件、实验指导书、参考资料。上传接口接收 MultipartFile把文件写到 upload.path 对应的课程目录再把文件信息写入 course_resource 表PostMapping(/resource/upload) ResponseBody public MapString, Object uploadResource(RequestParam(file) MultipartFile file, RequestParam(courseId) Integer courseId, HttpServletRequest request) { MapString, Object result new HashMap(); if (file.isEmpty()) { result.put(code, 500); result.put(msg, 文件不能为空); return result; } String originalName file.getOriginalFilename(); String ext originalName.substring(originalName.lastIndexOf(.)); String storedName UUID.randomUUID().toString().replace(-, ) ext; String dirPath uploadPath File.separator course_ courseId; File dir new File(dirPath); if (!dir.exists()) { dir.mkdirs(); } try { file.transferTo(new File(dir, storedName)); } catch (IOException e) { result.put(code, 500); result.put(msg, 文件保存失败); return result; } CourseResource resource new CourseResource(); resource.setCourseId(courseId); resource.setOriginalName(originalName); resource.setStoredName(storedName); resource.setFilePath(/course/ courseId / storedName); resource.setFileSize(file.getSize()); courseResourceService.add(resource); result.put(code, 200); result.put(msg, 上传成功); return result; }文件重名、中文名是上传接口最常见的麻烦这里用 UUID 重命名存储文件原始文件名单独存在 originalName 字段里展示和下载时用原始名磁盘上则不需要担心中文名或空格引发的问题。按课程 ID 分目录是为了避免单目录文件过多也方便教师清理某门课的历史资源。下载接口通过文件 ID 先查 course_resource再拼出磁盘路径。返回文件时会把 originalName 做 URL 编码并用 filename* 参数告诉浏览器用中文名保存避免出现「下载下来的文件名全是乱码」的体验问题。如果你在改造时把 uploadPath 换成了云存储地址只需要改 filePath 的读取逻辑Controller 结构不用动。3.3 作业模块:布置、提交、批改的状态流转作业模块体现在作业表和提交表两张表上。教师创建作业时只写 homework 表学生交作业时往 homework_submit 插一条记录并把状态从「未提交」的概念落到实际数据上。提交代码如下PostMapping(/homework/submit) public String submitHomework(RequestParam(homeworkId) Integer homeworkId, RequestParam(content) String content, RequestParam(value file, required false) MultipartFile file, HttpSession session) { User user (User) session.getAttribute(user); HomeworkSubmit submit new HomeworkSubmit(); submit.setHomeworkId(homeworkId); submit.setStudentId(user.getId()); submit.setContent(content); submit.setStatus(SUBMITTED); if (file ! null !file.isEmpty()) { submit.setAttachmentPath(saveAttachment(file)); } homeworkService.submit(submit); return redirect:/homework/detail/ homeworkId; }第一次提交和补交都走同一个接口但提交前会先按 homeworkId 和 studentId 查一下已有记录如果已经交过就把老记录的 status 标记为「已更新」再插入新记录。这样做的好处是教师批改时看到的是最新一版同时保留历史提交记录便于期末核对。教师端的批改页面展示的是作业详情和所有提交记录打到分数后更新 homework_submit 的 score 和 status。查询未提交学生名单是课设里比较加分的一个功能SQL 上用 course 下的所有学生 LEFT JOIN 提交表再筛提交记录为空的记录这样的写法比 NOT IN 在数据量变大时更不容易出错。业务上注意 deadline 的判断要放在 Service 层而不是只靠前端禁用按钮否则绕过页面的请求照样能提交。3.4 在线测验:自动判分的前后端配合在线测验让网站不只是一个资料库学生答完题立即能看到分数。自动判分的核心逻辑在提交接口里它读取 quiz_question 表的所有题目遍历时拿表单里的答案和 correct_answer 比对PostMapping(/quiz/submit) ResponseBody public MapString, Object submitQuiz(RequestParam(quizId) Integer quizId, HttpServletRequest request) { ListQuizQuestion questions quizService.listQuestions(quizId); int score 0; for (QuizQuestion question : questions) { String submitted request.getParameter(question_ question.getId()); if (submitted ! null question.getCorrectAnswer().equalsIgnoreCase(submitted)) { score 10; } } quizService.saveRecord(quizId, loginUserId, score); MapString, Object result new HashMap(); result.put(code, 200); result.put(score, score); result.put(total, questions.size() * 10); return result; }表单里每个题目控件的 name 是 question_ 加题目 ID后台通过 request.getParameter 取值不用额外解析 JSON。判分规则默认每题 10 分总分等于题目数乘以 10这里就可以看出为什么数据库设计里要有正确的 correct_answer 字段。这里有个容易被忽视的小坑如果题目是多选题前端传过来的是复选框拼接值equalsIgnoreCase 就比不上了。毕业设计版本里我一般只做单选题和判断题两种类型的答案都是单字母A 或 B、T 或 F判分逻辑最简单。如果你想做多选题需要约定分隔符比如答案存成 A,B,C比对时先 split 再排序比较。学生端显示成绩后教师后台还能按题目统计正确率这部分可以在二次开发时扩展。4. 从零跑通:环境准备、初始化数据库到浏览器验证4.1 环境清单:JDK、MySQL、Maven、IDE想把这个项目跑起来本地环境不用太新省事儿优先。JDK 用 1.8 兼容性最好MySQL 用 5.7 或 8.0 都行但连接串写法有差异。Maven 3.x 必备IDE 用 IDEA 或 Eclipse 都可以IDEA 对 Maven 工程的支持更省事。如果你还没装数据库装完 MySQL 后记得把服务启动起来并在命令行试一下mysql -u root -p能连上。很多同学卡在项目启动前的第一步就是 MySQL 没启动、密码记错、或者是数据库服务本身权限配置有出入。4.2 初始化数据库:用命令行或客户端执行脚本数据库脚本在 resources/db 目录下命名为 course_website.sql。打开看会发现脚本里包含 CREATE DATABASE 语句所以只需要在 MySQL 里执行一次mysql -u root -p course_website.sql图形化客户端导入也一样选中整个 SQL 文件执行。执行完成后切到 course_website 库确认能看到之前列出的那些核心表。如果表没建全优先检查脚本里是否有外键依赖顺序问题常见的翻车点是先建子表后建父表导致报错脚本里一般已经排好顺序不需要手动调整。初始化脚本里通常还包含几个演示账号比如管理员、教师、学生三类账号的 INSERT 语句。密码多数是明文或简单加密后的 123456具体看脚本里 user 表的插入内容。这里建议启动前先手动查一遍账号免得后面登录失败时还要回头怀疑数据库。4.3 修改配置并启动项目导入完成后打开 application.yml把 username 和 password 改成你自己的数据库账号upload.path 改成有写权限的目录。然后打开 Maven 面板执行 clean 和 package或者直接在 IDEA 里运行启动类mvn spring-boot:run看到 Tomcat started on port(s): 8080 表示启动成功。浏览器访问 http://localhost:8080一个课程教学网站的登录页就会出现在面前。如果没有出现登录页不要急着怀疑代码F12 看控制台报错信息最常见的是数据库连接失败或 JSP 没编译。提示如果日志里出现 Unable to start embedded Tomcat先回到 4.2 确认数据库脚本是否导入成功再回来改配置顺序不要反。4.4 功能验证:新注册一个学生账号走一遍完整流程跑通后建议按真实使用顺序验证一遍不要只看登录页。第一步用管理员或教师账号进入后台创建一个课程第二步在课程详情里上传一个课件文件同时发布一条作业和一次在线测验第三步退出账号用学生入口注册新账号选课成功后下载刚才的课件、提交作业、答一道测验题确认成绩能回显。每一步都要刷新数据库查看对应表的记录是否变化比如 course_resource 出现新行、homework_submit 状态变成 SUBMITTED。这样做还有一个好处你能快速知道整套代码的数据流动是否符合预期为后面改功能打基础。4.5 打包部署:想放到服务器上怎么办项目默认是 jar 包方式启动适合本地演示。但如果你用的是 JSP 页面打成可执行 jar 后放到服务器上Spring Boot 对 JSP 的支持会受限制页面经常出现 404。所以毕业设计要部署到远程服务器我更建议改成 war 包packagingwar/packaging然后在启动类里继承 SpringBootServletInitializer 并重写 configure 方法。执行mvn clean package -Dmaven.test.skiptrue后会生成 war 文件丢到外部容器的 webapps 目录启动容器后访问对应路径即可。这一步容易踩坑但第 5 章会专门说排查思路。5. 避坑手册:启动、上传、乱码、分页的常见问题排查5.1 数据库连接失败启动直接抛异常现象启动 Spring Boot 时控制台报 Communications link failure或者 Access denied for user。原因大部分情况是 application.yml 里的地址、端口、账号密码和本地库对不上剩下的是连接 URL 少了 serverTimezoneMySQL 8.0 驱动会拒绝连接。解决先在本机命令行试mysql -u root -p确认能连上再检查配置。连接串补上 serverTimezoneAsia/Shanghai字符集带 UTF-8。改完重启看是否换新错误。这里容易翻车的是改完没重启配置类没有重新加载还以为自己没改对。5.2 上传课件报 MaxUploadSizeExceededException现象教师上传一个十几 MB 的课件浏览器直接报 500日志里有 MaxUploadSizeExceededException。原因Spring Boot 默认限制单文件最大 1MB请求总大小 10MB显然不够用。解决在 application.yml 里增加 spring.servlet.multipart.max-file-size 和 max-request-size分别改成 20MB 和 100MB。设置完后注意如果打成 war 部署到外部容器还要检查容器是否也有上传大小限制否则本地正常、服务器上还是翻车。5.3 JSP 页面 404首页白屏现象项目能启动但访问根路径返回 404或者登录成功跳转后页面找不到。原因Spring Boot 打包成 jar 时 JSP 不在 classpath 里或者 spring.mvc.view.prefix 写错找不到 /WEB-INF/jsp。解决本地开发确认有 webapp 目录且 JSP 在 /WEB-INF/jsp 下另确认 application.yml 里的 view prefix 和 suffix 与实际路径一致。部署到服务器时改用 war 包方式别让 JSP 和 jar 死磕。这个坑在课设里几乎每届都有人踩提前确认能省下半天时间。5.4 初始化 SQL 导入后中文乱码登录失败现象导入脚本后查 user 表中文姓名全变成问号或者用默认账号登录失败。原因SQL 脚本本身是 UTF-8但执行导入时客户端连接字符集不是 UTF-8建表语句里的 CHARSET 被覆盖。解决导入前固定用SET NAMES utf8mb4;或在图形化客户端里把数据库连接字符集设成 UTF-8。登录失败先别怀疑代码用 SQL 直接查一下 user 表的账号是否存在、密码是否被转义。如果是明文 123456直接在数据库里改一条记录再登录能快速定位是数据问题还是逻辑问题。5.5 MyBatis 分页插件报 limit 相关异常或查询结果对不上现象分页查询时控制台报 limit 参数不存在或者第二页数据与第一页重复。原因课设项目里经常手动写 limit 或者依赖 PageHelper参数类型不匹配时 SQL 解析就出错。解决如果用了 PageHelper确认版本和 Spring Boot 版本兼容并检查 startPage 后面紧跟的必须是一条查询语句不能在中间插入其他操作。如果没引入分页插件就手动计算 offset 和 rows 传给 Mapper参数名与 XML 里 #{offset} 保持一致。这样排查完后分页逻辑才不会再出幺蛾子。6. 二次开发建议:给课设项目加一个成绩导出接口6.1 新增导出接口的思路作业批改完以后教师最想要的功能就是“一键导出成绩单”。与其在页面上一个个人复制不如在作业详情里加一个导出接口把 homework_submit 里的学生姓名和分数写到 Excel 文件里。代码大致是GetMapping(/homework/export/{homeworkId}) public void exportScore(PathVariable Integer homeworkId, HttpServletResponse response) throws IOException { ListHomeworkSubmit submits homeworkService.listSubmits(homeworkId); response.setContentType(application/vnd.ms-excel); response.setHeader(Content-Disposition, attachment; filenamescore.xls); Workbook workbook new HSSFWorkbook(); Sheet sheet workbook.createSheet(成绩); Row header sheet.createRow(0); header.createCell(0).setCellValue(学生姓名); header.createCell(1).setCellValue(提交时间); header.createCell(2).setCellValue(得分); int rowIdx 1; for (HomeworkSubmit submit : submits) { Row row sheet.createRow(rowIdx); row.createCell(0).setCellValue(submit.getStudentName()); row.createCell(1).setCellValue(submit.getSubmitTime().toString()); row.createCell(2).setCellValue(submit.getScore()); } workbook.write(response.getOutputStream()); }HSSFWorkbook 对应 .xls 格式课设项目数据量不大够用。如果你想要 .xlsx换 XSSFWorkbook 并把 content-type 改成对应的类型。改造点其实只有三个引入 POI 依赖、加一个查询提交记录的 Service 方法、加这个 Controller 接口页面里放一个普通的 a 标签就能触发下载。6.2 验证这一类小改造的两种方法改完以后不要只看接口通没通。第一种验证方式不登录直接访问 /homework/export/1应该被拦截器重定向到登录页而不是直接下载文件这能确认权限没被绕过。第二种验证方式用教师账号登录进入作业详情页点击导出用 Excel 打开文件确认学生姓名、提交时间、得分三列和数据库里查询结果一致。从那以后我每次接到课设源码都会把这些新增接口的权限验证当作必检查项先测未登录再测正常登录少走很多弯路希望帮到你。本文还有配套的精品资源点击获取
简介面向Java Web课程设计或毕业设计的教学网站完整源码对应“基于WEB操作系统课程教学网站”课题主要为计算机专业学生提供一个可复用、可运行的在线教学平台实现方案。压缩包共502个文件体积约8.57MB主要含有JSP页面、Java源文件、Class字节码、DB数据库脚本及CSS/JS/HTML前端资源同时保留大量BAK备份文件、GIF/JPG课件图片与Doc/Txt开发说明整体覆盖展示层、控制层、数据层和部署文档目录结构清晰适合对照学习。当前已有38人浏览/学习可结合源码与说明文档快速搭建系统。系统实现了课程讲义、视频教程、在线测试、答疑、作业提交、成绩查询等核心模块其中成绩管理支持录入、修改、查询与统计分析展现出较完整的教学业务逻辑项目说明与开发文档补充了系统架构、功能模块和使用方法便于理解JSP与Java交互、数据库表设计及请求处理流程也能直接支撑毕业设计答辩或后续二次开发。1. 别把它当成一个“课件下载站”:操作系统课程教学网站源码解决了什么拿到一份 java 毕业设计源码很多人第一反应是打开页面截图看 UI但真正决定这套课设能不能过答辩的是“课件、作业、测验”这三条业务线有没有闭环。这个基于 WEB 的操作系统课程教学网站不是简单放几个 PPT 链接的静态页它把课程资源管理、作业布置与提交、在线测验自动判分、后台用户管理全部做进了一个 Spring Boot 项目里。学生、教师、管理员三种角色各有一套操作入口。如果你正在找 Java 毕业设计、课程设计源码或者想从一份完整项目里学分层架构和权限控制这份代码值得拿来跑一遍再改。2. 整体架构与技术选型:Spring Boot MyBatis JSP 的分层设计2.1 技术栈:为什么这套组合适合毕业设计这个网站的代码结构是典型的单体应用Spring Boot 做基础框架MyBatis 做数据访问MySQL 存业务数据View 层用 JSP 加 Bootstrap 渲染。没有拆前端工程也没上微服务这在课程设计里反而是优点——答辩时候能一条链路讲清楚请求怎么从页面到数据库再返回页面不用跟老师解释跨域、网关、服务注册这些额外概念。三层架构划分很明确Controller 层只接收参数和做简单校验Service 层处理业务规则Mapper 层通过 XML 和数据库打交道。实体类放在 entity 包下和数据库表字段一一对应。以“上传课件”这个操作为例Controller 收到 MultipartFile 后交给 Service 记录文件元数据Mapper 再把它插进 course_resource 表每一步都能单独断点调试。对刚接触课设源码的同学来说这套组合最大的好处是资料多踩坑记录多。遇到 MyBatis 映射报错、JSP 标签不解析这类问题网上一搜基本都有答案。而且项目打包产物小普通笔记本跑起来不费劲。2.2 目录结构:拿到源码先看哪几个包解压之后你会看到标准的 Maven 工程下面这个目录结构基本就是源码的主干course-teaching-website ├── pom.xml ├── src/main │ ├── java/com/example/coursewebsite │ │ ├── controller # 页面跳转和接口入口 │ │ ├── service # 业务逻辑 │ │ ├── mapper # MyBatis 数据访问接口 │ │ ├── entity # 数据库实体 │ │ ├── interceptor # 登录拦截器 │ │ └── config # 配置类、拦截器注册 │ ├── resources │ │ ├── application.yml # 主配置文件 │ │ ├── mapper # MyBatis 的 XML 映射文件 │ │ └── db # 初始化 SQL 脚本 │ └── webapp/WEB-INF/jsp │ ├── admin # 管理员页面 │ ├── teacher # 教师页面 │ ├── student # 学生页面 │ └── common # 登录、注册、公共组件 └── README.md拿到手不要先从页面翻起先看三个地方application.yml 里数据库配置能不能对得上、db 目录下的 SQL 脚本有没有完整建表语句、controller 包下接口的 RequestMapping 是否符合角色路径。这三个地方确认完毕项目八成能跑起来。resources/mapper 目录存放着每个 Mapper 接口对应的 XML里面写的是真正的 SQL。课设项目里 SQL 往往不长但联表查询和统计语句值得仔细看比如“查询某作业还没提交的学生”用 NOT IN 还是 LEFT JOIN两种写法在数据量大的时候性能差异很明显。2.3 数据库设计:围绕教学闭环的核心表整个业务围绕课程展开主要表大致是下面这些表名作用关键字段user管理员、教师、学生统一用户表username、password、rolecourse课程信息包含课程名和归属教师name、teacher_id、chaptercourse_resource课程课件、实验指导书等资源course_id、file_path、file_sizehomework作业布置信息course_id、title、deadlinehomework_submit学生提交的作业记录homework_id、student_id、status、scorequiz在线测验基本信息course_id、title、start_time、end_timequiz_question测验题目和参考答案quiz_id、question_type、correct_answernotice课程公告title、content、create_timediscussion课程讨论区course_id、user_id、content、reply_touser 和 course 是基础表几乎所有功能都跟这两张表关联。作业表与提交表分开设计是我比较推荐的做法作业本身只存「布置了什么」提交记录才存「谁交了、分数多少」这样同一个学生多次提交或者补交时保留历史记录教师批改也只是更新提交表的 score 和 status不影响作业定义。题目表把参考答案直接放在 quiz_question 表里虽然简单粗暴但自动判分时只需要遍历题目集合逐一比对不用做复杂的答案匹配逻辑。如果课程设计需要展示「难度系数」加一列就行。数据库脚本在 resources/db 下导入时会自动建库建表后面第 4 章会讲具体操作。2.4 配置文件:先改端口、数据库、上传路径这三处Spring Boot 的配置集中在 application.yml最常见的本地运行配置如下server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/course_website?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: root servlet: multipart: max-file-size: 20MB max-request-size: 100MB mvc: view: prefix: /WEB-INF/jsp/ suffix: .jsp mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.coursewebsite.entity upload: path: /data/course-website/upload连接串里的 serverTimezoneAsia/Shanghai 不能省MySQL 8.0 驱动对时区要求严格少了它会抛 SQLException。max-file-size 默认只有 1MB课件 PPT 动辄几十 MB不改这个值一定会翻车。upload.path 是文件落盘的根目录记得改成你自己机器上的一个绝对路径否则上传接口可能因为没有写权限而失败。这里还有一个细节JSP 和 Spring Boot 默认的静态资源目录不同所以必须通过 spring.mvc.view.prefix 和 suffix 把视图解析指到 /WEB-INF/jsp。如果你打算打 war 包部署到外部容器还要在 pom.xml 里改 packaging 为 war这些放到第 4 章一起说。3. 核心模块拆解:登录、上传、作业、测验的代码链路3.1 登录认证与拦截器:Session 方案在课设里的性价比网站把用户分成学生、教师、管理员页面上直接体现为不同角色的首页菜单。权限控制没有引入 Spring Security而是用拦截器加 Session这在毕业设计里很常见逻辑直观答辩也容易解释。核心拦截器代码大致这样public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String uri request.getRequestURI(); if (uri.startsWith(/login) || uri.startsWith(/register) || uri.startsWith(/css) || uri.startsWith(/js) || uri.startsWith(/images)) { return true; } HttpSession session request.getSession(); User user (User) session.getAttribute(user); if (user null) { response.sendRedirect(request.getContextPath() /login); return false; } request.setAttribute(loginUser, user); return true; } }这段代码做了两件事放行登录注册和静态资源其余请求一律检查 Session 里有没有 user。查到用户就把它塞到 request 属性里后续 Controller 和 JSP 页面直接用 loginUser 读取当前用户。没有登录的统一重定向到登录页避免出现「直接访问 /teacher/home 越权」的情况。角色细粒度控制我一般不放拦截器而是在各个 Controller 方法里判断 user.getRole()比如教师管理页面只允许 role 等于 teacher 或 admin 的请求通过。原因是课设项目角色少写一个通用注解成本反而高不如在每个关键接口前面加一行判断清晰。拦截器注册到 WebMvcConfigurer 的 addInterceptors 方法里注意排除路径一定要写上静态资源否则 CSS 全部加载不出来。3.2 课件资源的上传与下载:本地磁盘存储课程资源是整个网站的核心数据包括教学课件、实验指导书、参考资料。上传接口接收 MultipartFile把文件写到 upload.path 对应的课程目录再把文件信息写入 course_resource 表PostMapping(/resource/upload) ResponseBody public MapString, Object uploadResource(RequestParam(file) MultipartFile file, RequestParam(courseId) Integer courseId, HttpServletRequest request) { MapString, Object result new HashMap(); if (file.isEmpty()) { result.put(code, 500); result.put(msg, 文件不能为空); return result; } String originalName file.getOriginalFilename(); String ext originalName.substring(originalName.lastIndexOf(.)); String storedName UUID.randomUUID().toString().replace(-, ) ext; String dirPath uploadPath File.separator course_ courseId; File dir new File(dirPath); if (!dir.exists()) { dir.mkdirs(); } try { file.transferTo(new File(dir, storedName)); } catch (IOException e) { result.put(code, 500); result.put(msg, 文件保存失败); return result; } CourseResource resource new CourseResource(); resource.setCourseId(courseId); resource.setOriginalName(originalName); resource.setStoredName(storedName); resource.setFilePath(/course/ courseId / storedName); resource.setFileSize(file.getSize()); courseResourceService.add(resource); result.put(code, 200); result.put(msg, 上传成功); return result; }文件重名、中文名是上传接口最常见的麻烦这里用 UUID 重命名存储文件原始文件名单独存在 originalName 字段里展示和下载时用原始名磁盘上则不需要担心中文名或空格引发的问题。按课程 ID 分目录是为了避免单目录文件过多也方便教师清理某门课的历史资源。下载接口通过文件 ID 先查 course_resource再拼出磁盘路径。返回文件时会把 originalName 做 URL 编码并用 filename* 参数告诉浏览器用中文名保存避免出现「下载下来的文件名全是乱码」的体验问题。如果你在改造时把 uploadPath 换成了云存储地址只需要改 filePath 的读取逻辑Controller 结构不用动。3.3 作业模块:布置、提交、批改的状态流转作业模块体现在作业表和提交表两张表上。教师创建作业时只写 homework 表学生交作业时往 homework_submit 插一条记录并把状态从「未提交」的概念落到实际数据上。提交代码如下PostMapping(/homework/submit) public String submitHomework(RequestParam(homeworkId) Integer homeworkId, RequestParam(content) String content, RequestParam(value file, required false) MultipartFile file, HttpSession session) { User user (User) session.getAttribute(user); HomeworkSubmit submit new HomeworkSubmit(); submit.setHomeworkId(homeworkId); submit.setStudentId(user.getId()); submit.setContent(content); submit.setStatus(SUBMITTED); if (file ! null !file.isEmpty()) { submit.setAttachmentPath(saveAttachment(file)); } homeworkService.submit(submit); return redirect:/homework/detail/ homeworkId; }第一次提交和补交都走同一个接口但提交前会先按 homeworkId 和 studentId 查一下已有记录如果已经交过就把老记录的 status 标记为「已更新」再插入新记录。这样做的好处是教师批改时看到的是最新一版同时保留历史提交记录便于期末核对。教师端的批改页面展示的是作业详情和所有提交记录打到分数后更新 homework_submit 的 score 和 status。查询未提交学生名单是课设里比较加分的一个功能SQL 上用 course 下的所有学生 LEFT JOIN 提交表再筛提交记录为空的记录这样的写法比 NOT IN 在数据量变大时更不容易出错。业务上注意 deadline 的判断要放在 Service 层而不是只靠前端禁用按钮否则绕过页面的请求照样能提交。3.4 在线测验:自动判分的前后端配合在线测验让网站不只是一个资料库学生答完题立即能看到分数。自动判分的核心逻辑在提交接口里它读取 quiz_question 表的所有题目遍历时拿表单里的答案和 correct_answer 比对PostMapping(/quiz/submit) ResponseBody public MapString, Object submitQuiz(RequestParam(quizId) Integer quizId, HttpServletRequest request) { ListQuizQuestion questions quizService.listQuestions(quizId); int score 0; for (QuizQuestion question : questions) { String submitted request.getParameter(question_ question.getId()); if (submitted ! null question.getCorrectAnswer().equalsIgnoreCase(submitted)) { score 10; } } quizService.saveRecord(quizId, loginUserId, score); MapString, Object result new HashMap(); result.put(code, 200); result.put(score, score); result.put(total, questions.size() * 10); return result; }表单里每个题目控件的 name 是 question_ 加题目 ID后台通过 request.getParameter 取值不用额外解析 JSON。判分规则默认每题 10 分总分等于题目数乘以 10这里就可以看出为什么数据库设计里要有正确的 correct_answer 字段。这里有个容易被忽视的小坑如果题目是多选题前端传过来的是复选框拼接值equalsIgnoreCase 就比不上了。毕业设计版本里我一般只做单选题和判断题两种类型的答案都是单字母A 或 B、T 或 F判分逻辑最简单。如果你想做多选题需要约定分隔符比如答案存成 A,B,C比对时先 split 再排序比较。学生端显示成绩后教师后台还能按题目统计正确率这部分可以在二次开发时扩展。4. 从零跑通:环境准备、初始化数据库到浏览器验证4.1 环境清单:JDK、MySQL、Maven、IDE想把这个项目跑起来本地环境不用太新省事儿优先。JDK 用 1.8 兼容性最好MySQL 用 5.7 或 8.0 都行但连接串写法有差异。Maven 3.x 必备IDE 用 IDEA 或 Eclipse 都可以IDEA 对 Maven 工程的支持更省事。如果你还没装数据库装完 MySQL 后记得把服务启动起来并在命令行试一下mysql -u root -p能连上。很多同学卡在项目启动前的第一步就是 MySQL 没启动、密码记错、或者是数据库服务本身权限配置有出入。4.2 初始化数据库:用命令行或客户端执行脚本数据库脚本在 resources/db 目录下命名为 course_website.sql。打开看会发现脚本里包含 CREATE DATABASE 语句所以只需要在 MySQL 里执行一次mysql -u root -p course_website.sql图形化客户端导入也一样选中整个 SQL 文件执行。执行完成后切到 course_website 库确认能看到之前列出的那些核心表。如果表没建全优先检查脚本里是否有外键依赖顺序问题常见的翻车点是先建子表后建父表导致报错脚本里一般已经排好顺序不需要手动调整。初始化脚本里通常还包含几个演示账号比如管理员、教师、学生三类账号的 INSERT 语句。密码多数是明文或简单加密后的 123456具体看脚本里 user 表的插入内容。这里建议启动前先手动查一遍账号免得后面登录失败时还要回头怀疑数据库。4.3 修改配置并启动项目导入完成后打开 application.yml把 username 和 password 改成你自己的数据库账号upload.path 改成有写权限的目录。然后打开 Maven 面板执行 clean 和 package或者直接在 IDEA 里运行启动类mvn spring-boot:run看到 Tomcat started on port(s): 8080 表示启动成功。浏览器访问 http://localhost:8080一个课程教学网站的登录页就会出现在面前。如果没有出现登录页不要急着怀疑代码F12 看控制台报错信息最常见的是数据库连接失败或 JSP 没编译。提示如果日志里出现 Unable to start embedded Tomcat先回到 4.2 确认数据库脚本是否导入成功再回来改配置顺序不要反。4.4 功能验证:新注册一个学生账号走一遍完整流程跑通后建议按真实使用顺序验证一遍不要只看登录页。第一步用管理员或教师账号进入后台创建一个课程第二步在课程详情里上传一个课件文件同时发布一条作业和一次在线测验第三步退出账号用学生入口注册新账号选课成功后下载刚才的课件、提交作业、答一道测验题确认成绩能回显。每一步都要刷新数据库查看对应表的记录是否变化比如 course_resource 出现新行、homework_submit 状态变成 SUBMITTED。这样做还有一个好处你能快速知道整套代码的数据流动是否符合预期为后面改功能打基础。4.5 打包部署:想放到服务器上怎么办项目默认是 jar 包方式启动适合本地演示。但如果你用的是 JSP 页面打成可执行 jar 后放到服务器上Spring Boot 对 JSP 的支持会受限制页面经常出现 404。所以毕业设计要部署到远程服务器我更建议改成 war 包packagingwar/packaging然后在启动类里继承 SpringBootServletInitializer 并重写 configure 方法。执行mvn clean package -Dmaven.test.skiptrue后会生成 war 文件丢到外部容器的 webapps 目录启动容器后访问对应路径即可。这一步容易踩坑但第 5 章会专门说排查思路。5. 避坑手册:启动、上传、乱码、分页的常见问题排查5.1 数据库连接失败启动直接抛异常现象启动 Spring Boot 时控制台报 Communications link failure或者 Access denied for user。原因大部分情况是 application.yml 里的地址、端口、账号密码和本地库对不上剩下的是连接 URL 少了 serverTimezoneMySQL 8.0 驱动会拒绝连接。解决先在本机命令行试mysql -u root -p确认能连上再检查配置。连接串补上 serverTimezoneAsia/Shanghai字符集带 UTF-8。改完重启看是否换新错误。这里容易翻车的是改完没重启配置类没有重新加载还以为自己没改对。5.2 上传课件报 MaxUploadSizeExceededException现象教师上传一个十几 MB 的课件浏览器直接报 500日志里有 MaxUploadSizeExceededException。原因Spring Boot 默认限制单文件最大 1MB请求总大小 10MB显然不够用。解决在 application.yml 里增加 spring.servlet.multipart.max-file-size 和 max-request-size分别改成 20MB 和 100MB。设置完后注意如果打成 war 部署到外部容器还要检查容器是否也有上传大小限制否则本地正常、服务器上还是翻车。5.3 JSP 页面 404首页白屏现象项目能启动但访问根路径返回 404或者登录成功跳转后页面找不到。原因Spring Boot 打包成 jar 时 JSP 不在 classpath 里或者 spring.mvc.view.prefix 写错找不到 /WEB-INF/jsp。解决本地开发确认有 webapp 目录且 JSP 在 /WEB-INF/jsp 下另确认 application.yml 里的 view prefix 和 suffix 与实际路径一致。部署到服务器时改用 war 包方式别让 JSP 和 jar 死磕。这个坑在课设里几乎每届都有人踩提前确认能省下半天时间。5.4 初始化 SQL 导入后中文乱码登录失败现象导入脚本后查 user 表中文姓名全变成问号或者用默认账号登录失败。原因SQL 脚本本身是 UTF-8但执行导入时客户端连接字符集不是 UTF-8建表语句里的 CHARSET 被覆盖。解决导入前固定用SET NAMES utf8mb4;或在图形化客户端里把数据库连接字符集设成 UTF-8。登录失败先别怀疑代码用 SQL 直接查一下 user 表的账号是否存在、密码是否被转义。如果是明文 123456直接在数据库里改一条记录再登录能快速定位是数据问题还是逻辑问题。5.5 MyBatis 分页插件报 limit 相关异常或查询结果对不上现象分页查询时控制台报 limit 参数不存在或者第二页数据与第一页重复。原因课设项目里经常手动写 limit 或者依赖 PageHelper参数类型不匹配时 SQL 解析就出错。解决如果用了 PageHelper确认版本和 Spring Boot 版本兼容并检查 startPage 后面紧跟的必须是一条查询语句不能在中间插入其他操作。如果没引入分页插件就手动计算 offset 和 rows 传给 Mapper参数名与 XML 里 #{offset} 保持一致。这样排查完后分页逻辑才不会再出幺蛾子。6. 二次开发建议:给课设项目加一个成绩导出接口6.1 新增导出接口的思路作业批改完以后教师最想要的功能就是“一键导出成绩单”。与其在页面上一个个人复制不如在作业详情里加一个导出接口把 homework_submit 里的学生姓名和分数写到 Excel 文件里。代码大致是GetMapping(/homework/export/{homeworkId}) public void exportScore(PathVariable Integer homeworkId, HttpServletResponse response) throws IOException { ListHomeworkSubmit submits homeworkService.listSubmits(homeworkId); response.setContentType(application/vnd.ms-excel); response.setHeader(Content-Disposition, attachment; filenamescore.xls); Workbook workbook new HSSFWorkbook(); Sheet sheet workbook.createSheet(成绩); Row header sheet.createRow(0); header.createCell(0).setCellValue(学生姓名); header.createCell(1).setCellValue(提交时间); header.createCell(2).setCellValue(得分); int rowIdx 1; for (HomeworkSubmit submit : submits) { Row row sheet.createRow(rowIdx); row.createCell(0).setCellValue(submit.getStudentName()); row.createCell(1).setCellValue(submit.getSubmitTime().toString()); row.createCell(2).setCellValue(submit.getScore()); } workbook.write(response.getOutputStream()); }HSSFWorkbook 对应 .xls 格式课设项目数据量不大够用。如果你想要 .xlsx换 XSSFWorkbook 并把 content-type 改成对应的类型。改造点其实只有三个引入 POI 依赖、加一个查询提交记录的 Service 方法、加这个 Controller 接口页面里放一个普通的 a 标签就能触发下载。6.2 验证这一类小改造的两种方法改完以后不要只看接口通没通。第一种验证方式不登录直接访问 /homework/export/1应该被拦截器重定向到登录页而不是直接下载文件这能确认权限没被绕过。第二种验证方式用教师账号登录进入作业详情页点击导出用 Excel 打开文件确认学生姓名、提交时间、得分三列和数据库里查询结果一致。从那以后我每次接到课设源码都会把这些新增接口的权限验证当作必检查项先测未登录再测正常登录少走很多弯路希望帮到你。本文还有配套的精品资源点击获取
