《基于 SpringMVC 框架下的精品课程管理平台》这个题目在计算机毕业设计里出现频率极高可以说是 Java Web 方向的“老熟人”了。我带过的学生里好几个选的都是这套“课程教学与互动交流系统”从选题、搭框架、跑通核心功能、写论文到最终答辩每一步都有固定的套路和容易翻车的地方。这篇文章我当成一份完整的设计笔记来写把这个平台拆成一个一个真实要开发的模块讲清楚每张表为什么要这样建、每个功能在 SpringMVC 里是怎么串起来的、以及本机调试和上线部署的各种坑。如果你正打算选这个题或者已经在写但被卡住了照着这个思路捋一遍心里会踏实很多。1. 项目整体设计与架构思路1.1 平台定位与技术选型它到底解决什么问题先把这个项目到底在做什么说清楚。很多同学答辩的时候讲不出亮点不是因为代码写得少而是没搞明白系统的核心价值。精品课程管理平台本质上解决的是高校教学中课程资源分散、师生互动效率低的问题——传统方式下课件靠 U 盘拷贝、作业靠邮件提交、讨论靠课后排队信息极度不对称。而这个平台把“课程信息发布、教学资源上传、作业布置与提交、公告通知、在线讨论”整合到一个 Web 系统里学生一个浏览器就能完成所有学习动作教师一个后台就能管理整门课程。技术选型上核心关键词是 java、SpringMVC、Web。完整的经典组合是 Spring SpringMVC MyBatis也就是常说的 SSM配合 MySQL 数据库和 JSP 前端页面。为什么很多高校的毕设题目仍然指定 SpringMVC 而不是 Spring Boot一方面是因为课程体系里 SSM 是经典教学内容另一方面是 SpringMVC 的请求分发、拦截器、视图解析这些概念能让你在答辩时把 Web 原理讲得更透彻。用 Spring Boot 做固然开发效率高但很多配置被自动完成了反而少了很多“可讲的知识点”。我的建议是如果题目已经写了 SpringMVC就老老实实按这个技术栈做重点在功能设计和架构层次上体现工作量。1.2 为什么选择 SpringMVC这套经典架构的优势和门槛SpringMVC 的核心思路是“前端控制器模式”所有请求先统一到达DispatcherServlet由它根据 URL 分发给对应的 ControllerController 处理业务后返回视图名或 JSON 数据再交给 ViewResolver 解析渲染。这个流程要能对着图说清楚因为答辩必问。它的分层思想也决定了整个项目的目录结构Controller 层负责接收请求和参数校验Service 层负责业务逻辑Dao 层Mapper负责数据库操作。这个分层不只是写代码的习惯而是后期排查问题时最重要的导航图——页面报错了先去 Controller 看数据不对了先去 Service 查SQL 报错了直接锁定 Mapper 文件。相比 Servlet 时代每个请求写一个 Servlet 的原始方式SpringMVC 大幅减少了样板代码一个类里可以通过RequestMapping配置多个接口。相比 Struts2SpringMVC 更加轻量方法传参和返回也直观得多。门槛其实主要在两个地方一个是配置文件多web.xml、spring-mvc.xml、applicationContext.xml 之间的关系容易搞混另一个是拦截器、异常处理、静态资源放行这些细节配置不好就会出现“登录拦截了 CSS”“POST 请求 405”这类神奇问题。这些都是后文我会详细展开的实操重点。1.3 模块划分与角色权限功能清单先理清楚毕设项目最怕的是上来就写代码写到一半发现功能对不上题目。先把平台按用户角色拆成三个端功能一目了然。角色核心功能典型操作管理员平台基础数据与用户管理用户审核、课程审核、公告发布、分类管理教师课程建设与教学管理创建课程、维护章节、上传资源、布置作业、批改打分、发起讨论学生在线学习与互动交流选课、浏览章节/资源、提交作业、提问回复、查看公告从技术实现角度这里最核心的设计是角色权限控制。不能只在前端页面做按钮隐藏必须在后端接口层面做校验。比如学生直接请求/teacher/course/delete这个 URL后台必须拦截掉。实现上常用两种方式一是基于拦截器对 URL 前缀做粗粒度控制比如/admin/**必须管理员才能访问、/teacher/**必须教师或管理员二是在 Service 方法里做细粒度判断比如教师只能删除自己创建的课程。我的建议是两层结合拦截器保证基础安全Service 层再做业务逻辑上的归属校验。模块划分清楚之后数据库设计就有方向了。功能决定表结构表结构反过来也影响功能实现的复杂度所以下一步必须把数据库这关过好。2. 数据库设计整个平台的“地基”2.1 核心表结构拆解数据库是整个项目里最不该赶工期的部分表建错了后面所有代码都要跟着返工。精品课程管理平台的核心表按业务域可以分为用户域、课程域、教学域、互动域四组。我下面直接给出一套经过验证的标准建表方案字段和类型都可以直接参考。用户表t_user是所有业务的基础CREATE TABLE t_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE COMMENT 登录账号, password VARCHAR(64) NOT NULL COMMENT 密码建议MD5或BCrypt加密, real_name VARCHAR(50) COMMENT 真实姓名, role TINYINT NOT NULL DEFAULT 3 COMMENT 1管理员 2教师 3学生, avatar VARCHAR(255) COMMENT 头像地址, email VARCHAR(100), phone VARCHAR(20), status TINYINT NOT NULL DEFAULT 1 COMMENT 1正常 0禁用, create_time DATETIME ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;课程域由课程、章节、资源三张表组成。课程表是核心章节和资源都是它的从属CREATE TABLE t_course ( id INT PRIMARY KEY AUTO_INCREMENT, course_name VARCHAR(100) NOT NULL, course_code VARCHAR(30) COMMENT 课程编号, cover VARCHAR(255) COMMENT 封面图, teacher_id INT NOT NULL COMMENT 授课教师ID, category VARCHAR(50) COMMENT 课程分类, description TEXT COMMENT 课程简介, status TINYINT DEFAULT 0 COMMENT 0未发布 1已发布, create_time DATETIME, update_time DATETIME ); CREATE TABLE t_chapter ( id INT PRIMARY KEY AUTO_INCREMENT, course_id INT NOT NULL, chapter_title VARCHAR(100) NOT NULL, chapter_order INT DEFAULT 0 COMMENT 章节顺序, content LONGTEXT COMMENT 章节内容可存富文本, create_time DATETIME ); CREATE TABLE t_resource ( id INT PRIMARY KEY AUTO_INCREMENT, course_id INT NOT NULL, chapter_id INT COMMENT 所属章节可为空, resource_name VARCHAR(150) NOT NULL, resource_path VARCHAR(255) NOT NULL COMMENT 存储路径, resource_type VARCHAR(20) COMMENT pdf/ppt/video等, file_size BIGINT, upload_time DATETIME );教学域包含选课、作业、作业提交、公告四张表。其中选课表是典型的多对多中间表CREATE TABLE t_student_course ( id INT PRIMARY KEY AUTO_INCREMENT, student_id INT NOT NULL, course_id INT NOT NULL, enroll_time DATETIME, UNIQUE KEY uk_student_course (student_id, course_id) ); CREATE TABLE t_homework ( id INT PRIMARY KEY AUTO_INCREMENT, course_id INT NOT NULL, teacher_id INT NOT NULL, title VARCHAR(150) NOT NULL, content TEXT, deadline DATETIME, create_time DATETIME ); CREATE TABLE t_homework_submit ( id INT PRIMARY KEY AUTO_INCREMENT, homework_id INT NOT NULL, student_id INT NOT NULL, content TEXT, file_path VARCHAR(255), submit_time DATETIME, score DECIMAL(5,2), teacher_comment VARCHAR(500), UNIQUE KEY uk_hw_student (homework_id, student_id) ); CREATE TABLE t_notice ( id INT PRIMARY KEY AUTO_INCREMENT, course_id INT NOT NULL, title VARCHAR(200) NOT NULL, content TEXT, create_time DATETIME );互动域主要做课程讨论与问答用两张表实现“帖子-回复”的结构CREATE TABLE t_discussion ( id INT PRIMARY KEY AUTO_INCREMENT, course_id INT NOT NULL, user_id INT NOT NULL, title VARCHAR(200) NOT NULL, content TEXT, view_count INT DEFAULT 0, reply_count INT DEFAULT 0, create_time DATETIME ); CREATE TABLE t_reply ( id INT PRIMARY KEY AUTO_INCREMENT, discussion_id INT NOT NULL, user_id INT NOT NULL, content TEXT, create_time DATETIME );这套表结构基本够支撑整个平台的演示和答辩了。字段类型上特别注意金额、分数用 DECIMAL不要把作业分数定义成 DOUBLE状态字段用 TINYINT 而不是 INT 或 VARCHAR既节省空间又语义明确。2.2 表关系与字段设计的原则先解释一下为什么学生的选课要单独建一张中间表。一个学生可以选择多门课程一门课程也可以被多个学生选择这是典型的多对多关系。如果把“学生的课程集合”直接平铺在学生表里字段无限膨胀且无法查询如果只放一门课则只能一对一。所以必须通过t_student_course这张关联表用 student_id 和 course_id 两个外键表达多对多关系再加一个唯一约束防止重复选课。作业提交表上的唯一约束uk_hw_student (homework_id, student_id)也很有讲究。业务上一个作业只允许学生提交一份所以用唯一约束保证数据层面不可能出现同一学生对同一作业的重复提交记录。如果你希望允许学生多次提交并保留历史版本那就去掉这个唯一约束再加一个version字段标识第几次提交。再补充几个实用原则。第一外键是否真的建要看场景。学校数据库课程里外键是重要概念实际毕设中如果对数据一致性要求不高也可以不建物理外键只保留逻辑外键字段查询全靠 JOIN这样可以减少插入数据的约束限制但答辩时你要能解释清楚这个取舍。第二所有表的 id 统一用自增主键业务唯一性用唯一索引约束比如 username。第三时间字段统一为 DATETIME避免 DATE 和 TIMESTAMP 混用导致排序和显示出问题。2.3 建表时容易被忽略的坑数据库层面的坑大多数在第一次跑数据的时候才会暴露下面几个是我见过反复踩的。第一个是字符集。字符集要统一用utf8mb4而不是默认的utf8。如果某些表是 utf8某些是 utf8mb4多表 JOIN 时中文或特殊字符可能出现乱码。更麻烦的是插入 emoji 会直接报错因为 utf8 本身存不下 4 字节的 emoji。第二个是字段命名不要用 MySQL 关键字。比如order、desc、group这些词一旦成了字段名SQL 语句就必须加反引号否则直接报 SQL 语法错误。我习惯统一用“表前缀_业务名”的格式既避免了关键字又能在多表 JOIN 时一眼看出字段归属。第三个是别把密码明文存进去。哪怕只是毕设也建议至少用 MD5 加盐或者用org.springframework.util.DigestUtils做一次 MD5 转换再入库。这个点看起来小但答辩评委特别容易问“你的系统安全性怎么体现”密码加密就是一个现成的亮点。3. 核心功能模块的实现细节3.1 登录认证与角色权限控制登录模块是所有功能的前提也是 SpringMVC 拦截器最典型的应用场景。先说登录的流程用户提交 username 和 passwordController 调用 Service 从数据库查出用户、验证密码、把用户对象放进 Session然后跳转到首页。这里最容易漏掉的是“退出登录”和“登录状态过期”的处理。Session 过期处理我用一个笔者自己常用的方案在拦截器里判断 Session 中是否存在 loginUser不存在就重定向到登录页同时可以带一个timeout参数用于页面提示。先写拦截器类public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); Object loginUser session.getAttribute(loginUser); if (loginUser null) { // 判断是否为Ajax请求Ajax请求不能直接重定向页面 String requestedWith request.getHeader(X-Requested-With); if (XMLHttpRequest.equals(requestedWith)) { response.setStatus(401); } else { response.sendRedirect(request.getContextPath() /login); } return false; } return true; } }然后在 spring-mvc.xml 里配置拦截范围mvc:interceptors mvc:interceptor mvc:mapping path/** / mvc:exclude-mapping path/login / mvc:exclude-mapping path/register / mvc:exclude-mapping path/static/** / bean classcom.course.interceptor.LoginInterceptor / /mvc:interceptor /mvc:interceptors这段配置有两个关键细节。一个是exclude-mapping必须把静态资源路径排除掉否则 JS、CSS 文件全被拦截页面样式全丢。另一个是拦截路径的写法/**表示所有路径都拦/static/**表示放行 static 目录下的所有静态资源。很多同学在这两个写法上栽过跟头因为少写或多写一个斜杠效果完全不同。角色权限控制在上面的基础上再加一层角色判断。比如管理员专属功能和管理页面拦截器里可以先确认登录再通过user.getRole()判断是否等于管理员角色否则返回 403 页面。要注意的是前端按钮和菜单的显示可以基于角色做隐藏但这个不能作为唯一安全措施真正的安全边界在后端接口和拦截器上。3.2 课程管理模块从后台维护到前台展示课程管理是整个平台的业务核心前端页面、后台接口、数据库操作都围绕它展开。教师创建课程时表单提交课程名称、课程编号、分类、简介等信息Controller 接收参数后组装成 Course 对象调用 Service 层完成入库然后上传封面图片。前端页面我会重点讲分页和条件查询。课程数量一多全量查询会拖慢页面速度所以课程列表必须分页。这里既可以用 PageHelper 插件也可以手写 LIMIT 分页。手写的思路是前端通过 URL 参数传 pageNum 和 pageSizeService 层先执行一次COUNT(*)拿到总条数再执行LIMIT ? , ?拿到当前页数据最后把结果封装成一个 PageResult 对象返回给页面。写出来大概是这个结构public PageResultCourse findPage(Integer pageNum, Integer pageSize, String keyword) { int offset (pageNum - 1) * pageSize; ListCourse list courseMapper.selectPage(keyword, offset, pageSize); Long total courseMapper.count(keyword); int totalPages (int) Math.ceil((double) total / pageSize); return new PageResult(list, total, totalPages, pageNum); }注意 offset 的计算第一页 pageNum 为 1 时 offset 为 0这个容易想当然写成(pageNum - 1) * pageSize后忘记减一导致第一页数据就漏一条。条件查询的 SQL 用动态 SQLMyBatis 的if标签判断 keyword 是否为空动态拼接WHERE course_name LIKE CONCAT(%, #{keyword}, %)。课程展示到前台时学生需要一个“选课/退选”的操作流程。选课就是向t_student_course里插入一条记录退课就是删除这条记录。注意这两个动作都需要分别判断是否已选过、是否还有作业未交。另一个细节是课程状态教师创建的课程默认 status 是 0未发布学生前台是看不到的只有教师确认发布后 status 变为 1前台课程列表才展示。这个状态机的设计虽然简单却是“精品课程建设”这个业务概念里很重要的一环。3.3 教学与互动模块作业、公告、讨论区的串联作业模块要完整实现“布置-提交-批改-公布成绩”的闭环。教师端在课程详情页里选择作业页签填写标题、内容和截止时间创建一条 homework 记录。作业列表页面需要显示“已提交人数/总人数”这个查询涉及到两表 JOINSELECT h.*, COUNT(s.id) AS submit_count FROM t_homework h LEFT JOIN t_homework_submit s ON h.id s.homework_id WHERE h.course_id #{courseId} GROUP BY h.id。用 LEFT JOIN 而不是 INNER JOIN是为了让没有学生提交的作业也能显示出来提交数为 0。学生提交作业时表单里既要有文本框填文字内容也要有文件上传控件。Controller 里除了处理文本参数还需要通过MultipartFile接收文件。提交之后的状态判断很关键如果已经提交过页面要显示“已提交”和教师的批改结果同时提供“重新提交但不得超过截止时间”的逻辑。截止时间判断放在后端做页面上的时间提醒只是辅助不能作为校验依据。公告模块相对简单但要注意展示顺序和权限。管理员和教师可以发布公告普通学生只有查看权限。公告列表按创建时间倒序排列同时要在课程详情页里把最新公告固定展示在顶部方便学生第一时间看到。互动讨论区是这类平台里的加分项也是评审老师容易关注的地方。实现上采用“发帖-回复”两级结构学生发起新帖填标题和内容其他学生或教师可以在帖子下面回复。发帖时往t_discussion表插入记录并关联当前登录用户和所属课程回复时往t_reply表插入记录同时用 UPDATE 语句把 discussion 表的 reply_count 加一。这里有一个事务问题需要注意插入回复和更新回复数最好放在同一个 Service 方法里并加上Transactional否则极端情况下帖子回复数会对不上。3.4 文件上传与静态资源处理课程资源、作业附件、头像、封面这些功能都离不开文件上传。SpringMVC 处理文件上传需要先在配置里注册CommonsMultipartResolverbean idmultipartResolver classorg.springframework.web.multipart.commons.CommonsMultipartResolver property namemaxUploadSize value104857600 / property namedefaultEncoding valueUTF-8 / /beanmaxUploadSize 设置的是单文件最大上传大小教程类的 PPT、PDF 一个几十兆很常见默认配置不调大就会上传失败。Controller 里接收文件的代码也有讲究RequestMapping(/upload) public String upload(RequestParam(file) MultipartFile file, HttpServletRequest request) throws IOException { String realPath request.getServletContext().getRealPath(/upload/); File dir new File(realPath); if (!dir.exists()) { dir.mkdirs(); } String originalFilename file.getOriginalFilename(); // 防止重名时间戳随机数拼接 String finalName System.currentTimeMillis() _ UUID.randomUUID().toString().substring(0, 6) _ originalFilename; file.transferTo(new File(dir, finalName)); // 返回相对路径存入数据库 return /upload/ finalName; }文件为什么一定要重命名因为真实的毕业设计场景里学生上传的作业叫“新建文档.docx”教师上传的课件叫“课件.ppt”重名概率太高不处理就会相互覆盖。用时间戳加随机数重命名数据库里存的是新文件名下载的时候再恢复展示原文件名这是最稳妥的做法。静态资源处理还有一层容易踩的坑。因为 DispatcherServlet 的映射是/会拦截所有请求SpringMVC 默认不知道去哪里找 CSS、JS、图片。在 spring-mvc.xml 里必须加一句资源映射mvc:resources mapping/static/** location/static/ /这段配置意味着 URL 以 /static 开头的请求会直接到项目根目录的 static 文件夹下找物理文件不再经过 Controller。图片、CSS、JS 全部放 static 目录后台的 HTML、JSP 页面放/WEB-INF/views/这个目录结构从项目一开始就要定好。4. 从本机调试到服务器部署的完整流程4.1 SpringMVC 与 MyBatis 核心配置很多同学项目里的代码本身没问题但环境一直跑不起来大概率是配置文件这几个地方出了问题。先说 web.xml这里承担了三件事加载 Spring 容器、加载 SpringMVC 前端控制器、配置编码过滤器。Spring 和 SpringMVC 的职责要分清。applicationContext.xml负责 Service、Dao、数据源等业务层组件spring-mvc.xml负责 Controller、视图解析器、静态资源、拦截器、注解驱动等 Web 层组件。ComponentScan 的扫描范围要避免重复spring-mvc.xml 里只扫描包含 controller 的包applicationContext.xml 里扫描 service 和 dao 的包。扫重了会有警告扫漏了则直接找不到 Bean 启动失败。MyBatis 的 SqlSessionFactoryBean 要配置数据源和 Mapper XML 地址bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource / property namemapperLocations valueclasspath:mapper/*.xml / property nametypeAliasesPackage valuecom.course.entity / property nameconfiguration refmybatisConfig / /bean再强调一个不起眼但影响巨大的配置JDBC 连接串末尾一定要带characterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai。不带编码参数数据库交互中文乱码不带 serverTimezone高版本 MySQL 和 JDBC 驱动会因为时区不确定直接报异常。4.2 本机调试的三个常见问题把项目导进 IDEA 后第一次启动大概率会遇到问题。我见的比较多的有三种。第一种是 Tomcat 端口被占用。报错信息里出现Port 8080 was already in use处理方式是netstat -ano | findstr 8080找到占用进程然后杀进程或者直接把 Tomcat 端口改成 8081。端口冲突本身不复杂但很多同学不知道怎么看占用所以这里单独列出来。第二种是 404但 Console 没报错。这种情况一般是请求路径写错了。如果 Controller 的RequestMapping(/course)配了类级路径方法级又写了/list完整访问路径就是/course/list。JSP 里表单的 action、Ajax 的 url、超链接的 href 都要拼上这个完整路径。另外一个隐蔽问题部署到 Tomcat 后项目有 contextPath比如/course_platform/页面里的绝对路径会多出这一层所以页面代码里统一用${pageContext.request.contextPath}拼路径不要写死的/course/list。第三种是 500。看到 500 先别慌要分两类排查一类是 JSP 页面的 Java 异常比如HTTP Status 500 - java.lang.NullPointerException通常是你 EL 表达式或 JSTL 标签里的属性名和 Model 里放的对不上另一类是 SQL 层的异常最典型的是 MyBatis 的Invalid bound statement (not found)这种十有八九是 Mapper.xml 文件里的 namespace 写错了或者 dao 接口和 xml 的 id 不匹配。4.3 打 War 包部署步骤与检查点毕设最后一般都要求上线到服务器或者至少在本地演示。我把完整步骤写在这里照着做不会出岔子。第一步准备数据库。在服务器上创建数据库然后按建表脚本顺序执行t_user→t_course→t_chapter→t_resource→t_student_course→t_homework→t_homework_submit→t_notice→t_discussion→t_reply。顺序不能乱因为外键依赖要先建主表。初始数据里要插入管理员账号和几个测试账号密码建议直接用代码里加密工具生成的密文不要用明文做初始化。第二步修改配置文件。把 jdbc.properties 里的数据库地址改成服务器的内网或公网地址账号密码改成服务器数据库的真实账号。如果是自己买的云服务器注意放行端口和安全组很多同学上线后报“连接不上数据库”排查优先级依次是云安全组规则、MySQL 的 bind-address、MySQL 用户是否允许远程访问。第三步使用 Maven 打 War 包。在项目根目录执行mvn clean package打包完成后 War 包在 target 目录下。把这个 War 包丢到 Tomcat 的 webapps 目录启动 Tomcat 后它会自动解压部署。首次启动多留意 catalina.out 日志Tomcat 启动没报错不代表项目初始化成功如果 Spring 容器初始化失败日志里会有明确的异常堆栈。第四步功能冒烟测试。部署完成后按“学生 → 教师 → 管理员”三个角色各走一遍核心流程重点关注登录、课程列表、作业提交、文件下载这几个跨模块功能。数据库连接、文件上传目录权限这类问题都会在冒烟测试阶段暴露出来。5. 常见问题排查与答辩经验分享5.1 问题排查速查表下面这张表我整理自真实开发中遇到的高频故障建议先收藏遇到问题直接对照排查。现象可能原因排查方向页面全裸无样式DispatcherServlet 拦截了静态资源检查 spring-mvc.xml 的 mvc:resources 配置登录后跳转死循环登录成功跳转的 URL 也被拦截器拦截检查拦截器的 exclude-mapping 清单中文乱码数据库、JSP、过滤器编码不一致全链路统一 UTF-8检查页面 contentType文件上传后找不到附件文件保存路径没有实时创建上传前检查物理目录是否存在不存在则 mkdirsSQL 执行报错 found non-nullable column实体类字段和表字段映射不匹配检查 resultMap 或驼峰映射配置列表页数据显示不出来Service 返回的 Model 属性名和页面取值不一致检查 model.addAttribute 的 key登录接口一直 405表单 POST 请求方法不对应检查 RequestMapping 的 method 属性Ajax 请求返回登录页面拦截器对 Ajax 请求做了重定向在 preHandle 中判断 X-Requested-With 并返回 401这里我再补充一个独家小技巧如果页面报错但控制台没有明显堆栈把 Tomcat 的日志级别调成 DEBUG 不一定有效更直接的方法是看 JSP 编译后的异常详细信息。很多 JSP 编译异常只提示所在行列但完整堆栈会带上具体是哪一行的方法调用出了问题。另外实体类字段建议都加上DateTimeFormat注解日期类型从前端传过来格式不对被 400 了找半天都不知道原因。5.2 答辩演示顺序与提问准备答辩演示的节奏非常影响评委印象。我的建议是围绕一条完整业务线串下来不要东点一下西点一下。按这个顺序演示最顺管理员登录创建课程并分配教师 → 教师登录给课程添加章节、上传课件、发布公告、布置作业 → 学生登录选课、学习章节、提交作业、在讨论区发帖追问 → 教师登录批改作业 → 管理员查看整体数据和用户状态。这条线走完整个平台的功能基本都覆盖了。答辩环节评委常问的几个问题提前准备答案SpringMVC 处理一个请求的完整流程是什么回答要点是 DispatcherServlet、HandlerMapping、Controller、ModelAndView、ViewResolver 五个环节这是送分题。拦截器和 Servlet 过滤器有什么区别回答从两个维度切入过滤器是 Servlet 规范里的组件依赖容器可以拦截所有资源包括静态资源拦截器是 SpringMVC 里的组件只拦截进入 Controller 的请求其执行在过滤链之后并且能访问 SpringIOC 容器中的 Bean。为什么数据库里要建中间表用学生选课的例子说明多对多关系转换。最后一个容易被问但很多同学准备不足的问题“你这个系统有什么不足”这里不要真的去说功能缺失而是要从技术优化角度讲比如“目前文件存储在本机磁盘后续可以引入专用的对象存储服务”“当前权限粒度只到角色层后续可以引入更细粒度的权限框架”之类既诚实又有思路的回答。最后说点实在的体会。这类 Java Web 毕设项目的核心不在于用了多新的技术而在于你能不能把一个完整业务链条想清楚并落地。我在实际带项目时最大的感受是数据库设计扎实了、核心流程跑通了整个系统就稳了一大半。如果时间紧张建议优先保证登录、课程管理、作业、讨论这四大块的完整度其他锦上添花的功能可以留到答辩前再补。这个平台做完你收获的不仅是一个能答辩的项目更是一整套从数据库建模到 Web 开发再到部署上线的实战能力。 基于SpringMVC的精品课程管理平台设计与实现全解析
《基于 SpringMVC 框架下的精品课程管理平台》这个题目在计算机毕业设计里出现频率极高可以说是 Java Web 方向的“老熟人”了。我带过的学生里好几个选的都是这套“课程教学与互动交流系统”从选题、搭框架、跑通核心功能、写论文到最终答辩每一步都有固定的套路和容易翻车的地方。这篇文章我当成一份完整的设计笔记来写把这个平台拆成一个一个真实要开发的模块讲清楚每张表为什么要这样建、每个功能在 SpringMVC 里是怎么串起来的、以及本机调试和上线部署的各种坑。如果你正打算选这个题或者已经在写但被卡住了照着这个思路捋一遍心里会踏实很多。1. 项目整体设计与架构思路1.1 平台定位与技术选型它到底解决什么问题先把这个项目到底在做什么说清楚。很多同学答辩的时候讲不出亮点不是因为代码写得少而是没搞明白系统的核心价值。精品课程管理平台本质上解决的是高校教学中课程资源分散、师生互动效率低的问题——传统方式下课件靠 U 盘拷贝、作业靠邮件提交、讨论靠课后排队信息极度不对称。而这个平台把“课程信息发布、教学资源上传、作业布置与提交、公告通知、在线讨论”整合到一个 Web 系统里学生一个浏览器就能完成所有学习动作教师一个后台就能管理整门课程。技术选型上核心关键词是 java、SpringMVC、Web。完整的经典组合是 Spring SpringMVC MyBatis也就是常说的 SSM配合 MySQL 数据库和 JSP 前端页面。为什么很多高校的毕设题目仍然指定 SpringMVC 而不是 Spring Boot一方面是因为课程体系里 SSM 是经典教学内容另一方面是 SpringMVC 的请求分发、拦截器、视图解析这些概念能让你在答辩时把 Web 原理讲得更透彻。用 Spring Boot 做固然开发效率高但很多配置被自动完成了反而少了很多“可讲的知识点”。我的建议是如果题目已经写了 SpringMVC就老老实实按这个技术栈做重点在功能设计和架构层次上体现工作量。1.2 为什么选择 SpringMVC这套经典架构的优势和门槛SpringMVC 的核心思路是“前端控制器模式”所有请求先统一到达DispatcherServlet由它根据 URL 分发给对应的 ControllerController 处理业务后返回视图名或 JSON 数据再交给 ViewResolver 解析渲染。这个流程要能对着图说清楚因为答辩必问。它的分层思想也决定了整个项目的目录结构Controller 层负责接收请求和参数校验Service 层负责业务逻辑Dao 层Mapper负责数据库操作。这个分层不只是写代码的习惯而是后期排查问题时最重要的导航图——页面报错了先去 Controller 看数据不对了先去 Service 查SQL 报错了直接锁定 Mapper 文件。相比 Servlet 时代每个请求写一个 Servlet 的原始方式SpringMVC 大幅减少了样板代码一个类里可以通过RequestMapping配置多个接口。相比 Struts2SpringMVC 更加轻量方法传参和返回也直观得多。门槛其实主要在两个地方一个是配置文件多web.xml、spring-mvc.xml、applicationContext.xml 之间的关系容易搞混另一个是拦截器、异常处理、静态资源放行这些细节配置不好就会出现“登录拦截了 CSS”“POST 请求 405”这类神奇问题。这些都是后文我会详细展开的实操重点。1.3 模块划分与角色权限功能清单先理清楚毕设项目最怕的是上来就写代码写到一半发现功能对不上题目。先把平台按用户角色拆成三个端功能一目了然。角色核心功能典型操作管理员平台基础数据与用户管理用户审核、课程审核、公告发布、分类管理教师课程建设与教学管理创建课程、维护章节、上传资源、布置作业、批改打分、发起讨论学生在线学习与互动交流选课、浏览章节/资源、提交作业、提问回复、查看公告从技术实现角度这里最核心的设计是角色权限控制。不能只在前端页面做按钮隐藏必须在后端接口层面做校验。比如学生直接请求/teacher/course/delete这个 URL后台必须拦截掉。实现上常用两种方式一是基于拦截器对 URL 前缀做粗粒度控制比如/admin/**必须管理员才能访问、/teacher/**必须教师或管理员二是在 Service 方法里做细粒度判断比如教师只能删除自己创建的课程。我的建议是两层结合拦截器保证基础安全Service 层再做业务逻辑上的归属校验。模块划分清楚之后数据库设计就有方向了。功能决定表结构表结构反过来也影响功能实现的复杂度所以下一步必须把数据库这关过好。2. 数据库设计整个平台的“地基”2.1 核心表结构拆解数据库是整个项目里最不该赶工期的部分表建错了后面所有代码都要跟着返工。精品课程管理平台的核心表按业务域可以分为用户域、课程域、教学域、互动域四组。我下面直接给出一套经过验证的标准建表方案字段和类型都可以直接参考。用户表t_user是所有业务的基础CREATE TABLE t_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE COMMENT 登录账号, password VARCHAR(64) NOT NULL COMMENT 密码建议MD5或BCrypt加密, real_name VARCHAR(50) COMMENT 真实姓名, role TINYINT NOT NULL DEFAULT 3 COMMENT 1管理员 2教师 3学生, avatar VARCHAR(255) COMMENT 头像地址, email VARCHAR(100), phone VARCHAR(20), status TINYINT NOT NULL DEFAULT 1 COMMENT 1正常 0禁用, create_time DATETIME ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;课程域由课程、章节、资源三张表组成。课程表是核心章节和资源都是它的从属CREATE TABLE t_course ( id INT PRIMARY KEY AUTO_INCREMENT, course_name VARCHAR(100) NOT NULL, course_code VARCHAR(30) COMMENT 课程编号, cover VARCHAR(255) COMMENT 封面图, teacher_id INT NOT NULL COMMENT 授课教师ID, category VARCHAR(50) COMMENT 课程分类, description TEXT COMMENT 课程简介, status TINYINT DEFAULT 0 COMMENT 0未发布 1已发布, create_time DATETIME, update_time DATETIME ); CREATE TABLE t_chapter ( id INT PRIMARY KEY AUTO_INCREMENT, course_id INT NOT NULL, chapter_title VARCHAR(100) NOT NULL, chapter_order INT DEFAULT 0 COMMENT 章节顺序, content LONGTEXT COMMENT 章节内容可存富文本, create_time DATETIME ); CREATE TABLE t_resource ( id INT PRIMARY KEY AUTO_INCREMENT, course_id INT NOT NULL, chapter_id INT COMMENT 所属章节可为空, resource_name VARCHAR(150) NOT NULL, resource_path VARCHAR(255) NOT NULL COMMENT 存储路径, resource_type VARCHAR(20) COMMENT pdf/ppt/video等, file_size BIGINT, upload_time DATETIME );教学域包含选课、作业、作业提交、公告四张表。其中选课表是典型的多对多中间表CREATE TABLE t_student_course ( id INT PRIMARY KEY AUTO_INCREMENT, student_id INT NOT NULL, course_id INT NOT NULL, enroll_time DATETIME, UNIQUE KEY uk_student_course (student_id, course_id) ); CREATE TABLE t_homework ( id INT PRIMARY KEY AUTO_INCREMENT, course_id INT NOT NULL, teacher_id INT NOT NULL, title VARCHAR(150) NOT NULL, content TEXT, deadline DATETIME, create_time DATETIME ); CREATE TABLE t_homework_submit ( id INT PRIMARY KEY AUTO_INCREMENT, homework_id INT NOT NULL, student_id INT NOT NULL, content TEXT, file_path VARCHAR(255), submit_time DATETIME, score DECIMAL(5,2), teacher_comment VARCHAR(500), UNIQUE KEY uk_hw_student (homework_id, student_id) ); CREATE TABLE t_notice ( id INT PRIMARY KEY AUTO_INCREMENT, course_id INT NOT NULL, title VARCHAR(200) NOT NULL, content TEXT, create_time DATETIME );互动域主要做课程讨论与问答用两张表实现“帖子-回复”的结构CREATE TABLE t_discussion ( id INT PRIMARY KEY AUTO_INCREMENT, course_id INT NOT NULL, user_id INT NOT NULL, title VARCHAR(200) NOT NULL, content TEXT, view_count INT DEFAULT 0, reply_count INT DEFAULT 0, create_time DATETIME ); CREATE TABLE t_reply ( id INT PRIMARY KEY AUTO_INCREMENT, discussion_id INT NOT NULL, user_id INT NOT NULL, content TEXT, create_time DATETIME );这套表结构基本够支撑整个平台的演示和答辩了。字段类型上特别注意金额、分数用 DECIMAL不要把作业分数定义成 DOUBLE状态字段用 TINYINT 而不是 INT 或 VARCHAR既节省空间又语义明确。2.2 表关系与字段设计的原则先解释一下为什么学生的选课要单独建一张中间表。一个学生可以选择多门课程一门课程也可以被多个学生选择这是典型的多对多关系。如果把“学生的课程集合”直接平铺在学生表里字段无限膨胀且无法查询如果只放一门课则只能一对一。所以必须通过t_student_course这张关联表用 student_id 和 course_id 两个外键表达多对多关系再加一个唯一约束防止重复选课。作业提交表上的唯一约束uk_hw_student (homework_id, student_id)也很有讲究。业务上一个作业只允许学生提交一份所以用唯一约束保证数据层面不可能出现同一学生对同一作业的重复提交记录。如果你希望允许学生多次提交并保留历史版本那就去掉这个唯一约束再加一个version字段标识第几次提交。再补充几个实用原则。第一外键是否真的建要看场景。学校数据库课程里外键是重要概念实际毕设中如果对数据一致性要求不高也可以不建物理外键只保留逻辑外键字段查询全靠 JOIN这样可以减少插入数据的约束限制但答辩时你要能解释清楚这个取舍。第二所有表的 id 统一用自增主键业务唯一性用唯一索引约束比如 username。第三时间字段统一为 DATETIME避免 DATE 和 TIMESTAMP 混用导致排序和显示出问题。2.3 建表时容易被忽略的坑数据库层面的坑大多数在第一次跑数据的时候才会暴露下面几个是我见过反复踩的。第一个是字符集。字符集要统一用utf8mb4而不是默认的utf8。如果某些表是 utf8某些是 utf8mb4多表 JOIN 时中文或特殊字符可能出现乱码。更麻烦的是插入 emoji 会直接报错因为 utf8 本身存不下 4 字节的 emoji。第二个是字段命名不要用 MySQL 关键字。比如order、desc、group这些词一旦成了字段名SQL 语句就必须加反引号否则直接报 SQL 语法错误。我习惯统一用“表前缀_业务名”的格式既避免了关键字又能在多表 JOIN 时一眼看出字段归属。第三个是别把密码明文存进去。哪怕只是毕设也建议至少用 MD5 加盐或者用org.springframework.util.DigestUtils做一次 MD5 转换再入库。这个点看起来小但答辩评委特别容易问“你的系统安全性怎么体现”密码加密就是一个现成的亮点。3. 核心功能模块的实现细节3.1 登录认证与角色权限控制登录模块是所有功能的前提也是 SpringMVC 拦截器最典型的应用场景。先说登录的流程用户提交 username 和 passwordController 调用 Service 从数据库查出用户、验证密码、把用户对象放进 Session然后跳转到首页。这里最容易漏掉的是“退出登录”和“登录状态过期”的处理。Session 过期处理我用一个笔者自己常用的方案在拦截器里判断 Session 中是否存在 loginUser不存在就重定向到登录页同时可以带一个timeout参数用于页面提示。先写拦截器类public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); Object loginUser session.getAttribute(loginUser); if (loginUser null) { // 判断是否为Ajax请求Ajax请求不能直接重定向页面 String requestedWith request.getHeader(X-Requested-With); if (XMLHttpRequest.equals(requestedWith)) { response.setStatus(401); } else { response.sendRedirect(request.getContextPath() /login); } return false; } return true; } }然后在 spring-mvc.xml 里配置拦截范围mvc:interceptors mvc:interceptor mvc:mapping path/** / mvc:exclude-mapping path/login / mvc:exclude-mapping path/register / mvc:exclude-mapping path/static/** / bean classcom.course.interceptor.LoginInterceptor / /mvc:interceptor /mvc:interceptors这段配置有两个关键细节。一个是exclude-mapping必须把静态资源路径排除掉否则 JS、CSS 文件全被拦截页面样式全丢。另一个是拦截路径的写法/**表示所有路径都拦/static/**表示放行 static 目录下的所有静态资源。很多同学在这两个写法上栽过跟头因为少写或多写一个斜杠效果完全不同。角色权限控制在上面的基础上再加一层角色判断。比如管理员专属功能和管理页面拦截器里可以先确认登录再通过user.getRole()判断是否等于管理员角色否则返回 403 页面。要注意的是前端按钮和菜单的显示可以基于角色做隐藏但这个不能作为唯一安全措施真正的安全边界在后端接口和拦截器上。3.2 课程管理模块从后台维护到前台展示课程管理是整个平台的业务核心前端页面、后台接口、数据库操作都围绕它展开。教师创建课程时表单提交课程名称、课程编号、分类、简介等信息Controller 接收参数后组装成 Course 对象调用 Service 层完成入库然后上传封面图片。前端页面我会重点讲分页和条件查询。课程数量一多全量查询会拖慢页面速度所以课程列表必须分页。这里既可以用 PageHelper 插件也可以手写 LIMIT 分页。手写的思路是前端通过 URL 参数传 pageNum 和 pageSizeService 层先执行一次COUNT(*)拿到总条数再执行LIMIT ? , ?拿到当前页数据最后把结果封装成一个 PageResult 对象返回给页面。写出来大概是这个结构public PageResultCourse findPage(Integer pageNum, Integer pageSize, String keyword) { int offset (pageNum - 1) * pageSize; ListCourse list courseMapper.selectPage(keyword, offset, pageSize); Long total courseMapper.count(keyword); int totalPages (int) Math.ceil((double) total / pageSize); return new PageResult(list, total, totalPages, pageNum); }注意 offset 的计算第一页 pageNum 为 1 时 offset 为 0这个容易想当然写成(pageNum - 1) * pageSize后忘记减一导致第一页数据就漏一条。条件查询的 SQL 用动态 SQLMyBatis 的if标签判断 keyword 是否为空动态拼接WHERE course_name LIKE CONCAT(%, #{keyword}, %)。课程展示到前台时学生需要一个“选课/退选”的操作流程。选课就是向t_student_course里插入一条记录退课就是删除这条记录。注意这两个动作都需要分别判断是否已选过、是否还有作业未交。另一个细节是课程状态教师创建的课程默认 status 是 0未发布学生前台是看不到的只有教师确认发布后 status 变为 1前台课程列表才展示。这个状态机的设计虽然简单却是“精品课程建设”这个业务概念里很重要的一环。3.3 教学与互动模块作业、公告、讨论区的串联作业模块要完整实现“布置-提交-批改-公布成绩”的闭环。教师端在课程详情页里选择作业页签填写标题、内容和截止时间创建一条 homework 记录。作业列表页面需要显示“已提交人数/总人数”这个查询涉及到两表 JOINSELECT h.*, COUNT(s.id) AS submit_count FROM t_homework h LEFT JOIN t_homework_submit s ON h.id s.homework_id WHERE h.course_id #{courseId} GROUP BY h.id。用 LEFT JOIN 而不是 INNER JOIN是为了让没有学生提交的作业也能显示出来提交数为 0。学生提交作业时表单里既要有文本框填文字内容也要有文件上传控件。Controller 里除了处理文本参数还需要通过MultipartFile接收文件。提交之后的状态判断很关键如果已经提交过页面要显示“已提交”和教师的批改结果同时提供“重新提交但不得超过截止时间”的逻辑。截止时间判断放在后端做页面上的时间提醒只是辅助不能作为校验依据。公告模块相对简单但要注意展示顺序和权限。管理员和教师可以发布公告普通学生只有查看权限。公告列表按创建时间倒序排列同时要在课程详情页里把最新公告固定展示在顶部方便学生第一时间看到。互动讨论区是这类平台里的加分项也是评审老师容易关注的地方。实现上采用“发帖-回复”两级结构学生发起新帖填标题和内容其他学生或教师可以在帖子下面回复。发帖时往t_discussion表插入记录并关联当前登录用户和所属课程回复时往t_reply表插入记录同时用 UPDATE 语句把 discussion 表的 reply_count 加一。这里有一个事务问题需要注意插入回复和更新回复数最好放在同一个 Service 方法里并加上Transactional否则极端情况下帖子回复数会对不上。3.4 文件上传与静态资源处理课程资源、作业附件、头像、封面这些功能都离不开文件上传。SpringMVC 处理文件上传需要先在配置里注册CommonsMultipartResolverbean idmultipartResolver classorg.springframework.web.multipart.commons.CommonsMultipartResolver property namemaxUploadSize value104857600 / property namedefaultEncoding valueUTF-8 / /beanmaxUploadSize 设置的是单文件最大上传大小教程类的 PPT、PDF 一个几十兆很常见默认配置不调大就会上传失败。Controller 里接收文件的代码也有讲究RequestMapping(/upload) public String upload(RequestParam(file) MultipartFile file, HttpServletRequest request) throws IOException { String realPath request.getServletContext().getRealPath(/upload/); File dir new File(realPath); if (!dir.exists()) { dir.mkdirs(); } String originalFilename file.getOriginalFilename(); // 防止重名时间戳随机数拼接 String finalName System.currentTimeMillis() _ UUID.randomUUID().toString().substring(0, 6) _ originalFilename; file.transferTo(new File(dir, finalName)); // 返回相对路径存入数据库 return /upload/ finalName; }文件为什么一定要重命名因为真实的毕业设计场景里学生上传的作业叫“新建文档.docx”教师上传的课件叫“课件.ppt”重名概率太高不处理就会相互覆盖。用时间戳加随机数重命名数据库里存的是新文件名下载的时候再恢复展示原文件名这是最稳妥的做法。静态资源处理还有一层容易踩的坑。因为 DispatcherServlet 的映射是/会拦截所有请求SpringMVC 默认不知道去哪里找 CSS、JS、图片。在 spring-mvc.xml 里必须加一句资源映射mvc:resources mapping/static/** location/static/ /这段配置意味着 URL 以 /static 开头的请求会直接到项目根目录的 static 文件夹下找物理文件不再经过 Controller。图片、CSS、JS 全部放 static 目录后台的 HTML、JSP 页面放/WEB-INF/views/这个目录结构从项目一开始就要定好。4. 从本机调试到服务器部署的完整流程4.1 SpringMVC 与 MyBatis 核心配置很多同学项目里的代码本身没问题但环境一直跑不起来大概率是配置文件这几个地方出了问题。先说 web.xml这里承担了三件事加载 Spring 容器、加载 SpringMVC 前端控制器、配置编码过滤器。Spring 和 SpringMVC 的职责要分清。applicationContext.xml负责 Service、Dao、数据源等业务层组件spring-mvc.xml负责 Controller、视图解析器、静态资源、拦截器、注解驱动等 Web 层组件。ComponentScan 的扫描范围要避免重复spring-mvc.xml 里只扫描包含 controller 的包applicationContext.xml 里扫描 service 和 dao 的包。扫重了会有警告扫漏了则直接找不到 Bean 启动失败。MyBatis 的 SqlSessionFactoryBean 要配置数据源和 Mapper XML 地址bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource / property namemapperLocations valueclasspath:mapper/*.xml / property nametypeAliasesPackage valuecom.course.entity / property nameconfiguration refmybatisConfig / /bean再强调一个不起眼但影响巨大的配置JDBC 连接串末尾一定要带characterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai。不带编码参数数据库交互中文乱码不带 serverTimezone高版本 MySQL 和 JDBC 驱动会因为时区不确定直接报异常。4.2 本机调试的三个常见问题把项目导进 IDEA 后第一次启动大概率会遇到问题。我见的比较多的有三种。第一种是 Tomcat 端口被占用。报错信息里出现Port 8080 was already in use处理方式是netstat -ano | findstr 8080找到占用进程然后杀进程或者直接把 Tomcat 端口改成 8081。端口冲突本身不复杂但很多同学不知道怎么看占用所以这里单独列出来。第二种是 404但 Console 没报错。这种情况一般是请求路径写错了。如果 Controller 的RequestMapping(/course)配了类级路径方法级又写了/list完整访问路径就是/course/list。JSP 里表单的 action、Ajax 的 url、超链接的 href 都要拼上这个完整路径。另外一个隐蔽问题部署到 Tomcat 后项目有 contextPath比如/course_platform/页面里的绝对路径会多出这一层所以页面代码里统一用${pageContext.request.contextPath}拼路径不要写死的/course/list。第三种是 500。看到 500 先别慌要分两类排查一类是 JSP 页面的 Java 异常比如HTTP Status 500 - java.lang.NullPointerException通常是你 EL 表达式或 JSTL 标签里的属性名和 Model 里放的对不上另一类是 SQL 层的异常最典型的是 MyBatis 的Invalid bound statement (not found)这种十有八九是 Mapper.xml 文件里的 namespace 写错了或者 dao 接口和 xml 的 id 不匹配。4.3 打 War 包部署步骤与检查点毕设最后一般都要求上线到服务器或者至少在本地演示。我把完整步骤写在这里照着做不会出岔子。第一步准备数据库。在服务器上创建数据库然后按建表脚本顺序执行t_user→t_course→t_chapter→t_resource→t_student_course→t_homework→t_homework_submit→t_notice→t_discussion→t_reply。顺序不能乱因为外键依赖要先建主表。初始数据里要插入管理员账号和几个测试账号密码建议直接用代码里加密工具生成的密文不要用明文做初始化。第二步修改配置文件。把 jdbc.properties 里的数据库地址改成服务器的内网或公网地址账号密码改成服务器数据库的真实账号。如果是自己买的云服务器注意放行端口和安全组很多同学上线后报“连接不上数据库”排查优先级依次是云安全组规则、MySQL 的 bind-address、MySQL 用户是否允许远程访问。第三步使用 Maven 打 War 包。在项目根目录执行mvn clean package打包完成后 War 包在 target 目录下。把这个 War 包丢到 Tomcat 的 webapps 目录启动 Tomcat 后它会自动解压部署。首次启动多留意 catalina.out 日志Tomcat 启动没报错不代表项目初始化成功如果 Spring 容器初始化失败日志里会有明确的异常堆栈。第四步功能冒烟测试。部署完成后按“学生 → 教师 → 管理员”三个角色各走一遍核心流程重点关注登录、课程列表、作业提交、文件下载这几个跨模块功能。数据库连接、文件上传目录权限这类问题都会在冒烟测试阶段暴露出来。5. 常见问题排查与答辩经验分享5.1 问题排查速查表下面这张表我整理自真实开发中遇到的高频故障建议先收藏遇到问题直接对照排查。现象可能原因排查方向页面全裸无样式DispatcherServlet 拦截了静态资源检查 spring-mvc.xml 的 mvc:resources 配置登录后跳转死循环登录成功跳转的 URL 也被拦截器拦截检查拦截器的 exclude-mapping 清单中文乱码数据库、JSP、过滤器编码不一致全链路统一 UTF-8检查页面 contentType文件上传后找不到附件文件保存路径没有实时创建上传前检查物理目录是否存在不存在则 mkdirsSQL 执行报错 found non-nullable column实体类字段和表字段映射不匹配检查 resultMap 或驼峰映射配置列表页数据显示不出来Service 返回的 Model 属性名和页面取值不一致检查 model.addAttribute 的 key登录接口一直 405表单 POST 请求方法不对应检查 RequestMapping 的 method 属性Ajax 请求返回登录页面拦截器对 Ajax 请求做了重定向在 preHandle 中判断 X-Requested-With 并返回 401这里我再补充一个独家小技巧如果页面报错但控制台没有明显堆栈把 Tomcat 的日志级别调成 DEBUG 不一定有效更直接的方法是看 JSP 编译后的异常详细信息。很多 JSP 编译异常只提示所在行列但完整堆栈会带上具体是哪一行的方法调用出了问题。另外实体类字段建议都加上DateTimeFormat注解日期类型从前端传过来格式不对被 400 了找半天都不知道原因。5.2 答辩演示顺序与提问准备答辩演示的节奏非常影响评委印象。我的建议是围绕一条完整业务线串下来不要东点一下西点一下。按这个顺序演示最顺管理员登录创建课程并分配教师 → 教师登录给课程添加章节、上传课件、发布公告、布置作业 → 学生登录选课、学习章节、提交作业、在讨论区发帖追问 → 教师登录批改作业 → 管理员查看整体数据和用户状态。这条线走完整个平台的功能基本都覆盖了。答辩环节评委常问的几个问题提前准备答案SpringMVC 处理一个请求的完整流程是什么回答要点是 DispatcherServlet、HandlerMapping、Controller、ModelAndView、ViewResolver 五个环节这是送分题。拦截器和 Servlet 过滤器有什么区别回答从两个维度切入过滤器是 Servlet 规范里的组件依赖容器可以拦截所有资源包括静态资源拦截器是 SpringMVC 里的组件只拦截进入 Controller 的请求其执行在过滤链之后并且能访问 SpringIOC 容器中的 Bean。为什么数据库里要建中间表用学生选课的例子说明多对多关系转换。最后一个容易被问但很多同学准备不足的问题“你这个系统有什么不足”这里不要真的去说功能缺失而是要从技术优化角度讲比如“目前文件存储在本机磁盘后续可以引入专用的对象存储服务”“当前权限粒度只到角色层后续可以引入更细粒度的权限框架”之类既诚实又有思路的回答。最后说点实在的体会。这类 Java Web 毕设项目的核心不在于用了多新的技术而在于你能不能把一个完整业务链条想清楚并落地。我在实际带项目时最大的感受是数据库设计扎实了、核心流程跑通了整个系统就稳了一大半。如果时间紧张建议优先保证登录、课程管理、作业、讨论这四大块的完整度其他锦上添花的功能可以留到答辩前再补。这个平台做完你收获的不仅是一个能答辩的项目更是一整套从数据库建模到 Web 开发再到部署上线的实战能力。