每年到这个节点就有一大批同学在毕设选题和开发的边缘反复试探。我见过太多人被“教学资料管理系统”这个名字误导觉得它简单结果一动手才发现——用户体系、文件上传下载、权限控制、前后端联调、服务器部署每一环都能卡上两三天。这个题目听起来朴素但它实际上覆盖了一个完整业务系统的全部标准要素用Java、Vue、SpringBoot这套组合做下来你从数据库设计到项目上线能完整走一遍比很多花哨选题实用得多。这篇文章我会把这个系统的业务拆解、技术选型、数据库表设计、后端核心接口、前端页面联调、服务器部署以及最后论文答辩的应对思路全部串起来讲。不管你是拿它做毕业设计还是想练手SpringBoot全家桶全栈项目都可以直接照着这套思路落地。1. 这个系统到底要解决什么问题——业务背景与需求拆解1.1 毕设题目里的教学资料管理远没有表面那么简单先说业务背景。大多数高校的课程资料分发到今天还是靠U盘拷贝、QQ群文件、网盘链接体验很差QQ群文件过期、网盘下载限速、U盘传播容易中病毒老师想更新一份课件往往要在群里发好几遍。教学资料管理系统要解决的就是资料集中存储、按课程分类、带权限控制、支持快速检索下载这一整条链路。但你要是真去做毕业设计光理解到这一层还不够。因为这个系统真正值钱的地方在于它具备了一个完整业务系统最常见、也最典型的三个要素多角色用户体系管理员、教师、学生不同角色看到的内容和能做的操作完全不同。文件的上传与下载涉及文件命名、存储路径、大小限制、响应头处理这些都是后端开发的高频考点。分类、检索与展示按课程维度组织资料支持模糊搜索和分页列表。换句话说这个题目就是给你一个合理的业务场景让你把用户管理、文件管理、权限控制、前后端交互、部署上线这些通用能力全部打通一遍。搞定它你以后再遇到类似的管理类系统公告管理、题库管理、选课系统思路基本是复用的。1.2 三种角色、三条主流程先把业务边界划清楚做系统之前第一步永远是划角色边界。我建议把用户分成三种权限从低到高排列学生登录后可以浏览课程列表按课程查看资料列表检索资料下载。不能上传、不能删除。教师除了学生的全部权限还能上传自己课程下的资料、删除自己上传的资料。不能动其他老师的资料。管理员用户管理增删改查、分配角色、重置密码、课程管理、所有资料的查看与删除、系统公告发布。对应到业务流程核心就是三条学生/教师登录 → 课程列表 → 单门课程的资料列表 → 检索 → 下载。教师登录 → 选择课程 → 上传资料填标题、选类型→ 在自己的上传列表里管理文件。管理员登录 → 用户管理/课程管理 → 维护基础数据 → 处理违规或过期资料。这里有一个很多同学容易漏掉的需求资料上传时要不要审核我的建议是如果做的是教学资料管理系统默认不审核教师上传后学生立即可见逻辑更简洁演示时也顺畅。如果你想增加亮点可以加一个待审核状态字段管理员审核后展示但这会额外增加一套流程和界面时间不够的建议先不做。另一个容易被忽略的点是文件类型和大小限制。正常教学场景里资料以PDF、Word、PPT、压缩包为主偶尔有视频。系统里要有允许上传的扩展名配置同时要限制单文件大小比如50MB以内。这些在SpringBoot里都是几行配置的事但很多同学不写上传一个几百MB的视频直接把服务器磁盘打满。2. 技术选型为什么这个组合成了毕业设计的事实标准2.1 SpringBoot Vue不是随便选的每一步都有理由你打开任何一个毕设网站Java方向几乎全是SpringBoot Vue的搭配。这个组合能成为事实标准确实是有原因的。先看后端。SpringBoot最核心的价值是自动配置内置Tomcat不需要你手动搭建容器打一个jar包直接能跑。生态又极其成熟SpringMVC处理接口、SpringSecurity或JWT做认证、MyBatis-Plus操作数据库每个环节都有大量现成的资料和排错文章。更重要的是大部分同学的Java基础停留在教科书层面SpringBoot的starter机制大幅降低了上手门槛。版本选择上我有明确建议用SpringBoot 2.7.x不要用3.x。原因有三点第一3.x强制要求JDK17很多学校机房和服务器还停留在JDK8答辩现场环境不兼容非常尴尬第二MyBatis-Plus对SpringBoot 3的支持需要额外适配第三绝大多数网上的教程、CSDN博客、踩坑贴都是基于2.x写的你遇到问题搜到的方案基本都是2.x的直接抄作业能少走很多弯路。前端为什么选Vue因为Vue的学习曲线比React更平缓而且Element UI/Element Plus这套组件库对管理类系统来说是降维打击。你要做一个带表格、表单、弹窗、导航的后台界面根本不需要自己写组件拖出来就能用。这里再给一个更细致的建议如果你是2022年之后做项目直接上Vue 3 Vite Element Plus。不要再碰Vue 2了。虽然老教程多但Vue 3的Composition API写起来更清爽Vite的启动速度比Webpack快一个数量级而且新项目没必要学旧技术栈。2.2 数据库、ORM、认证方案的选择逻辑数据库层面MySQL 8.0是当下的默认选择没有之一。字符集必须用utf8mb4不然存emoji或者某些生僻字会乱码。ORM我用的是MyBatis-Plus选它的理由很直接——单表CRUD不需要手写SQL内置分页插件还有LambdaQueryWrapper这种链式查询写法代码量能减少一半。认证方案上主流有两种Session和JWT。对于前后端分离的项目我强烈推荐JWTJSON Web Token。原因很简单Session依赖服务器端存储要额外配置跨域携带Cookie部署到云服务器后还要处理会话共享的问题而JWT是无状态的后端签发一个Token给前端前端每次请求放到请求头里后端拦截器验签即可不需要考虑分布式会话。我见过太多同学用Session做前后端分离部署后登录失效了半天找不出原因——问题就出在Cookie跨域上。整个技术栈最终是这一套层级技术选型说明后端框架SpringBoot 2.7.x JDK8稳定、资料多、兼容性好数据库MySQL 8.0默认选择utf8mb4字符集ORMMyBatis-Plus 3.5.x分页插件、Lambda查询认证JWT 拦截器无状态认证适合前后端分离前端Vue 3 Vite Element Plus组件化开发UI效率高前端HTTPAxios封装请求/响应拦截器文件存储本地磁盘路径简单直观答辩好解释这套选型不是最先进的但它是最不容易翻车的。毕业生做项目首要目标是稳定跑通、逻辑清晰、答辩能自圆其说而不是秀技术新颖度。2.3 文件存储的选型本地磁盘打底对象存储做扩展文件存储是这类系统绕不开的问题。常见的方案有四种本地磁盘存储、FastDFS、MinIO、云厂商OSS。我的建议分两层毕设阶段用本地磁盘存储报告里把MinIO或OSS作为扩展点来写。本地磁盘存储的做法很简单就是后台上传时把文件写到服务器的某个目录比如/data/files/数据库里存文件的存储路径下载时根据路径读文件返回给前端。好处是架构简单、逻辑一目了然、答辩时老师问文件存哪里你直接带他看服务器目录坏处是文件多了之后单机磁盘扛不住、无法水平扩展。但这些缺点恰恰可以作为报告里系统不足与展望章节的素材。如果你想让系统看起来更有工业感也可以在报告里写本系统预留了MinIO对象存储的扩展接口后续可将fileService替换为MinIO客户端实现。这一句话就能让老师觉得你对存储架构演进有认知。3. 数据库设计教学资料管理的核心表结构3.1 三张核心表是怎么拆出来的数据库设计是毕设答辩的重灾区很多同学表建得乱七八糟字段重复、关系混乱一被问到就支支吾吾。其实这个系统遵循一个非常朴素的原则按业务对象建表一个核心对象一张表。这个系统里核心业务对象有三个用户、课程、资料。所以最小的表集合就是三张sys_user用户表存放登录账号、密码、角色。course课程表存放课程名称、课程代码、授课教师。material资料表存放资料名、文件路径、所属课程、上传人、下载次数。三张表的关系也很直接资料属于某一门课程material.course_id关联course.id资料由某个用户上传material.uploader_id关联sys_user.id。这里有一个常见的过度设计给课程-学生建中间表。如果你要做学生只能看自己选修课程的资料这种细粒度权限确实需要一张选课关系表。但毕设阶段我建议不做因为大部分教学资料系统的权限边界只需要到角色层级——所有登录学生都能看所有课程资料教师只能管自己上传的资料。这样权限逻辑简化成了角色判断 资料归属判断接口实现难度小一个档次演示也流畅。等报告写后续优化方向时再提选课关系和细粒度数据权限。3.2 一张完整的建表SQL与字段设计思路下面是我实际项目里用的建表SQL可以直接抄字段都带注释-- 用户表 CREATE TABLE sys_user ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT 主键ID, username VARCHAR(50) NOT NULL COMMENT 登录用户名, password VARCHAR(100) NOT NULL COMMENT 密码(MD5加密), real_name VARCHAR(50) DEFAULT NULL COMMENT 真实姓名, role TINYINT DEFAULT 2 COMMENT 角色:0管理员 1教师 2学生, email VARCHAR(100) DEFAULT NULL COMMENT 邮箱, status TINYINT DEFAULT 1 COMMENT 状态:1启用 0禁用, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 更新时间, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB AUTO_INCREMENT1 DEFAULT CHARSETutf8mb4 COMMENT用户表; -- 课程表 CREATE TABLE course ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT 主键ID, course_code VARCHAR(20) NOT NULL COMMENT 课程代码, course_name VARCHAR(100) NOT NULL COMMENT 课程名称, teacher_id BIGINT DEFAULT NULL COMMENT 授课教师ID, credit INT DEFAULT 2 COMMENT 学分, description VARCHAR(500) DEFAULT NULL COMMENT 课程描述, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间, PRIMARY KEY (id), UNIQUE KEY uk_course_code (course_code) ) ENGINEInnoDB AUTO_INCREMENT1 DEFAULT CHARSETutf8mb4 COMMENT课程表; -- 资料表 CREATE TABLE material ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT 主键ID, title VARCHAR(200) NOT NULL COMMENT 资料标题, original_name VARCHAR(255) NOT NULL COMMENT 原始文件名, storage_path VARCHAR(255) NOT NULL COMMENT 服务器存储路径, file_type VARCHAR(20) DEFAULT NULL COMMENT 文件扩展名, file_size BIGINT DEFAULT 0 COMMENT 文件大小(字节), course_id BIGINT NOT NULL COMMENT 所属课程ID, uploader_id BIGINT NOT NULL COMMENT 上传人ID, download_count INT DEFAULT 0 COMMENT 下载次数, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 上传时间, PRIMARY KEY (id), KEY idx_course_id (course_id), KEY idx_uploader_id (uploader_id) ) ENGINEInnoDB AUTO_INCREMENT1 DEFAULT CHARSETutf8mb4 COMMENT教学资料表;这套设计里有几个字段我特意做了处理答辩时可以说出理由original_name原始文件名和storage_path存储路径分开存。实际保存到服务器时文件名统一用UUID重命名防止重名覆盖和中文路径乱码但展示给用户时必须显示原始文件名所以单独存一个字段。file_size用BIGINT存字节数不要用字符串或者浮点数。前端展示时再把字节换算成KB/MB这样可以精确统计存储空间。file_type只存扩展名如pdf、docx、ppt不要存MIME类型。因为MIME类型在不同的浏览器环境下可能不同而扩展名是稳定的前端根据扩展名渲染对应图标更简单。**download_count下载次数**是一个低成本高收益字段。它就是一个普通的SELECT count加一但对系统演示很有用——可以做一个热门资料下载排行功能报告里能多写一页答辩时也是一个实际业务价值的体现。如果你还有时间可以补一张notice公告表和一张sys_user_role角色扩展表。但核心这三张表已经能让整个系统闭环跑起来了。4. 后端核心功能一路写下来会踩的坑都在这里4.1 文件上传接口UUID重命名与路径安全后端最核心的接口有三个上传、下载、分页检索。先说上传。上传接口用SpringMVC的MultipartFile接收文件核心逻辑分四步校验文件是否为空、扩展名是否在白名单内。用UUID生成新的文件名保留原扩展名。根据当前日期生成子目录避免所有文件堆在一个文件夹里。保存文件到磁盘把文件信息写入数据库。核心代码大致是这样PostMapping(/upload) public Result upload(RequestParam(file) MultipartFile file, RequestParam(courseId) Long courseId, RequestParam(title) String title, RequestHeader(Authorization) String token) { if (file.isEmpty()) { return Result.error(上传文件不能为空); } String originalName file.getOriginalFilename(); String ext originalName.substring(originalName.lastIndexOf(.) 1).toLowerCase(); // 扩展名白名单校验 ListString allowedExt Arrays.asList(pdf, doc, docx, ppt, pptx, zip, rar, txt, png, jpg); if (!allowedExt.contains(ext)) { return Result.error(不支持的文件类型: ext); } // 生成存储文件名: yyyyMMdd/UUID.扩展名 String datePath LocalDate.now().toString().replace(-, ); String uuidName UUID.randomUUID().toString().replace(-, ) . ext; String dirPath /data/files/ datePath; File dir new File(dirPath); if (!dir.exists()) { dir.mkdirs(); } File targetFile new File(dir, uuidName); try { file.transferTo(targetFile.getAbsoluteFile()); } catch (Exception e) { log.error(文件保存失败, e); return Result.error(文件保存失败: e.getMessage()); } // 解析上传人ID Long uploaderId JwtUtil.getUserId(token); // 保存数据库记录 Material material new Material(); material.setTitle(title); material.setOriginalName(originalName); material.setStoragePath(targetFile.getAbsolutePath()); material.setFileType(ext); material.setFileSize(file.getSize()); material.setCourseId(courseId); material.setUploaderId(uploaderId); materialService.save(material); return Result.success(上传成功, material.getId()); }这段代码里有三个细节值得注意file.transferTo(targetFile.getAbsoluteFile())一定要传绝对路径对象否则在某些环境下会报临时目录文件找不到的错误。Spring处理MultipartFile时实际上文件先被写到了Tomcat的临时目录transferTo执行的是原子重命名操作传入相对路径时容易定位失败。扩展名判断一定要小写化。不然用户上传一个.PDF会被拦截现场演示时很尴尬。上传目录权限。如果你把文件写到服务器的/data/files/要确保这个目录存在且有写权限。我见过太多人部署后上传一直报错最后发现是mkdirs没有生效目录权限是只读的。4.2 文件下载接口中文文件名与响应头处理下载接口的坑比上传多最典型的就是中文文件名乱码。当你设置Content-Disposition: attachment; filename课件.pdf时如果文件名包含中文Chrome很可能会乱码或截断。标准做法是使用RFC 5987规范把文件名进行URL编码同时提供一个filename*参数GetMapping(/download/{id}) public ResponseEntityResource download(PathVariable Long id) { Material material materialService.getById(id); if (material null) { return ResponseEntity.notFound().build(); } File file new File(material.getStoragePath()); if (!file.exists()) { return ResponseEntity.notFound().build(); } // 下载次数1 material.setDownloadCount(material.getDownloadCount() 1); materialService.updateById(material); // 构造响应头 HttpHeaders headers new HttpHeaders(); headers.setContentType(MediaType.APPLICATION_OCTET_STREAM); String encodedFileName URLEncoder.encode(material.getOriginalName(), StandardCharsets.UTF_8).replaceAll(\\, %20); headers.add(Content-Disposition, attachment; filename*UTF-8 encodedFileName); Resource resource new FileSystemResource(file.getAbsolutePath()); return ResponseEntity.ok() .headers(headers) .contentLength(file.length()) .body(resource); }我单独说三个点URLEncoder.encode之后要replaceAll(\\, %20)否则文件名里的空格会变成下载出来的文件名不干净。filename*UTF-8xxx是RFC 5987的标准写法现代浏览器都能正确解析。老式的filenamexxx作为兜底已经没必要写了如果一定要写注意字符串转义。下载加1这个操作建议直接放在查询之后、返回之前。如果并发量不大没问题大了可以后续用异步或者Redis优化毕设阶段不需要过度设计。4.3 分页检索与JWT权限拦截分页检索这个功能MyBatis-Plus几乎把代码量降到了最低。一个LambdaQueryWrapper组合条件查询再加分页插件就完成了GetMapping(/list) public Result list(RequestParam(defaultValue 1) Integer pageNum, RequestParam(defaultValue 10) Integer pageSize, RequestParam(required false) Long courseId, RequestParam(required false) String keyword) { PageMaterial page new Page(pageNum, pageSize); LambdaQueryWrapperMaterial wrapper new LambdaQueryWrapper(); if (courseId ! null) { wrapper.eq(Material::getCourseId, courseId); } if (StringUtils.hasText(keyword)) { wrapper.like(Material::getTitle, keyword).or().like(Material::getOriginalName, keyword); } wrapper.orderByDesc(Material::getCreateTime); PageMaterial result materialService.page(page, wrapper); // 这里最好把文件名、大小、上传时间等前端展示字段做一次转换再返回 return Result.success(result); }注意上面keyword的like查询如果同时查标题和原始文件名要用or()连接不然会把条件变成AND搜出来结果为空。这个很隐蔽很多人排查半天查不到原因。然后是JWT权限拦截。我建议做一个自定义HandlerInterceptor拦截除登录注册外的接口解析请求头里的Authorization把用户信息放到ThreadLocal里。核心代码如下public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 放行跨域预检请求 if (OPTIONS.equalsIgnoreCase(request.getMethod())) { return true; } String token request.getHeader(Authorization); if (token ! null token.startsWith(Bearer )) { token token.substring(7); } try { Claims claims JwtUtil.parseToken(token); UserContext.setUserId(claims.get(userId, Long.class)); return true; } catch (Exception e) { response.setStatus(401); response.setContentType(application/json;charsetUTF-8); response.getWriter().write({\code\:401,\msg\:\登录已过期或未登录\}); return false; } } }然后注册到WebMvcConfigurer里注意排除登录、注册、端口探测等公开接口以及放行静态资源。这里经常有人忘记放行OPTIONS预检请求导致前端调试时接口一直在CORS报错但后端日志又看不到任何请求——问题就出在预检请求被拦截器挡了。5. Vue前端与接口联调从页面撸到上线最容易翻车的环节5.1 前端工程结构与Axios封装前端部分我建议用现成的Vue 3 Vite工程模板初始化目录结构大致如下src/ ├── api/ # 接口请求封装 │ ├── user.js │ └── material.js ├── assets/ # 静态资源 ├── components/ # 公共组件上传组件、分页组件等 ├── router/ # 路由配置 ├── stores/ # Pinia状态管理用户信息、Token ├── views/ # 页面 │ ├── Login.vue │ ├── Layout.vue │ ├── CourseManage.vue │ ├── MaterialList.vue │ ├── UploadMaterial.vue │ └── UserManage.vue ├── utils/ │ └── request.js # Axios实例封装 └── App.vue很多人一上来就写页面我建议先封装Axios请求实例这是整个前端联调的基石。封装的核心逻辑有两个第一请求拦截器里自动加Authorization头import axios from axios import { ElMessage } from element-plus import router from /router const request axios.create({ baseURL: /api, // 开发环境走Vite代理生产环境走Nginx代理 timeout: 15000 }) request.interceptors.request.use(config { const token localStorage.getItem(token) if (token) { config.headers.Authorization Bearer token } return config }) request.interceptors.response.use( response response.data, error { if (error.response error.response.status 401) { localStorage.removeItem(token) router.push(/login) } ElMessage.error(error.response?.data?.msg || 请求失败) return Promise.reject(error) } ) export default request这里把baseURL设置成/api开发环境通过Vite的代理转发到http://localhost:8080生产环境通过Nginx反向代理到后端端口。这个设计极其重要如果你在baseURL里直接写http://localhost:8080部署之后就必须改代码才能切到服务器地址而且跨域问题层出不穷。用相对路径/api配合反向代理本地和线上都不用改前端代码。5.2 文件上传与blob下载的细节上传组件用Element Plus的el-upload它支持自定义请求函数很多人第一次用会卡在怎么把token带给上传接口。其实很简单配置headers属性即可el-upload action/api/material/upload :data{ courseId: currentCourseId, title: fileTitle } :headers{ Authorization: Bearer localStorage.getItem(token) } :on-successhandleUploadSuccess accept.pdf,.doc,.docx,.ppt,.pptx,.zip el-button typeprimary选择文件/el-button /el-upload但ElUpload默认的action是表单提交方式如果后端接口是用RequestParam接收参数这种方式没问题。如果你的监听逻辑要更精细比如上传前做文件类型预判、大小校验更推荐用before-upload钩子拦截或者在:http-request里用封装的Axios实例上传这样能统一走请求拦截器不用手动拼headers。再讲下载。因为我们的后端下载接口会返回文件流前端如果用window.open(/api/material/download/ id)最大的问题是无法携带Authorization请求头。所以要用Axios配responseType: blob的方式请求拿到Blob后转成临时下载链接async function downloadFile(id, originalName) { const res await request.get(/material/download/${id}, { responseType: blob }) const blob new Blob([res]) const url window.URL.createObjectURL(blob) const link document.createElement(a) link.href url link.download originalName || download_ id document.body.appendChild(link) link.click() document.body.removeChild(link) window.URL.revokeObjectURL(url) }但注意因为Axios拦截器默认返回的是response.data这里res其实已经是Blob对象了。如果你后端在响应头里带了Content-Disposition还可以从中解析出真实文件名这样即使在数据库操作时原始文件名变了前端也能拿到正确的下载名。解析方式const disposition error.response?.headers?.[content-disposition] const match disposition disposition.match(/filename\*UTF-8([^;])/) let fileName decodeURIComponent(match?.[1]) || download_文件5.3 跨域问题开发环境Vite代理生产环境Nginx代理跨域是前后端分离项目里必然遇到、也最容易劝退新手的问题。解决方案只有一个主原则生产环境不要用后端CORS用Nginx代理解决开发环境用Vite的server.proxy配置。开发环境在vite.config.js里这样写export default defineConfig({ server: { proxy: { /api: { target: http://localhost:8080, changeOrigin: true // 不需要 rewrite因为后端接口统一有 /api 前缀 } } } })生产环境在Nginx配置里加一段location /api/ { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_read_timeout 300s; # 大文件上传/下载需要调大 }注意proxy_pass这里用一个很容易踩坑的知识点如果你写成proxy_pass http://127.0.0.1:8080/;末尾带了斜杠那么/api/material/list会被转发成/material/list路径中的/api会被剥掉。如果不带斜杠则原样转发。你必须和后端接口的RequestMapping前缀保持一致否则就会出现前端报404、后端日志什么都没有的诡异问题。6. 部署上线从本机到服务器的完整避坑清单6.1 服务器准备与基础软件安装这台系统用最低配的云服务器就能跑2核2G就足够了。系统选CentOS 7或Ubuntu 20.04/22.04都行。Java项目部署需要装的东西就三样JDK 8、MySQL 8、Nginx。有个安装JDK的快捷方式用包管理器搞定比手动解压靠谱得多# Ubuntu/Debian apt update apt install -y openjdk-8-jdk nginx mysql-server # CentOS yum install -y java-1.8.0-openjdk nginx mysql-serverMySQL装完后第一件事就是导入数据库脚本mysql -u root -p CREATE DATABASE edu_material DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE edu_material; SOURCE /root/edu_material.sql;先建库再导入注意建库时指定utf8mb4字符集不然表里的默认字符集大概率还是latin1一旦存入中文就会变成问号。创建专用的数据库账号尽量不要让SpringBoot直接用root连CREATE USER edu_user% IDENTIFIED BY 你的密码; GRANT ALL PRIVILEGES ON edu_material.* TO edu_user%; FLUSH PRIVILEGES;然后修改SpringBoot的application.yml里的数据库连接地址改成服务器的地址或localhost账号密码换成新建的。6.2 打包与发布后端jar包、前端dist本地开发完成后打包发布有这么几步。后端打包mvn clean package -DskipTests打出来的jar包在target/目录下传到服务器后启动nohup java -jar edu-material.jar --server.port8080 /data/logs/app.log 21 这里我强烈建议不要直接用nohup裸跑哪怕你嫌麻烦也得把日志输出到独立的目录。因为排查线上问题时日志就是你唯一的线索。更稳的方式是用systemd管理Java进程写一个服务配置[Unit] DescriptionEdu Material Server Afternetwork.target [Service] Typesimple Userroot WorkingDirectory/data/app ExecStart/usr/bin/java -jar /data/app/edu-material.jar Restartalways RestartSec5 StandardOutputappend:/data/logs/app.out.log StandardErrorappend:/data/logs/app.err.log [Install] WantedBymulti-user.target保存到/etc/systemd/system/edu-material.service然后systemctl daemon-reload systemctl enable edu-material systemctl start edu-material这样SpringBoot应用宕机后会自动拉起来重启服务器也会自动启动答辩前夜服务器意外重启也不至于当场翻车。前端打包npm run build打包生成的dist/目录直接放到Nginx的站点目录比如/usr/share/nginx/html/。然后用前面提到的Nginx配置把/api代理到8080端口。6.3 部署完成后必须检查的三件事每次部署完我都建议按下面这个顺序做一轮冒烟测试每一项都是我真实踩过的坑第一件事确认静态资源路径正确。Nginx默认站点根目录是/usr/share/nginx/html如果你把前端dist删了再上传页面应该是直接能打开登录页的。如果打开是403或404先检查目录权限chmod -R 755 /usr/share/nginx/html再检查Nginx配置里的index index.html。第二件事检查数据库时区。SpringBoot连接MySQL时如果application.yml里没有配置时区很可能会遇到相差8小时的问题。连接参数里加上spring: datasource: url: jdbc:mysql://localhost:3306/edu_material?useUnicodetruecharacterEncodingutf8mb4serverTimezoneAsia/ShanghaiuseSSLfalse servlet: multipart: max-file-size: 50MB max-request-size: 60MB顺带把上传大小限制也写上不然SpringBoot默认最大上传是1MB传个课件都报错。第三件事用浏览器隐身模式完整走一遍流程。从注册账号或使用预置账号登录到上传文件、检索、下载整个过程都不能报错。特别是文件下载重点观察中文文件名是否正确、下载进度条是否存在。这一步最好模拟干净环境操作排除浏览器缓存和Token残留的影响。7. 答辩指导老师最爱问的几个问题与应答思路7.1 技术类问题为什么、怎么办、有什么区别答辩室里的老师不全是Java方向的但问的问题高度集中在几个方向。我把高频问题列出来并给出你觉得现场能答出来的应答思路为什么用SpringBoot而不用传统SSH/SSM应答思路SSH/SSM时代大量的配置需要手动写XMLSpringBoot通过自动配置和starter机制把这些都封装好了项目启动内置Tomcat部署直接打jar包开发效率高。同时它的生态好想集成MyBatis-Plus、JWT、文件上传这些功能都有成熟的起步依赖。弱点层面可以说SpringBoot自动化程度高排错时需要对底层原理有一定理解但这不影响它作为快速开发框架的价值。为什么用JWT做认证Session不行吗应答思路前后端分离架构下Session依赖服务器端内存存储和Cookie传递存在跨域共享难、移动端不方便的问题。JWT把用户信息加密后放在Token里下发服务器无状态验签天然适合多端、分布式部署场景。同时指出JWT的局限性比如Token无法主动失效、过期时间需要合理设置所以系统里设置了合理的过期时间和拦截器中的校验逻辑。文件存储在哪如果文件太多怎么办应答思路当前设计是存储在本地磁盘通过yyyyMMdd日期目录分散存放避免单目录文件过多。如果未来文件量上升可以平滑迁移到MinIO对象存储或OSS因为上传和下载的逻辑已经封装在独立的Service层替换底层存储实现只需要改动这一个类对上面接口无感。你的密码为什么用MD5加密安全吗应答思路毕设项目为了简单使用了MD5加盐严格来说生产环境应该用BCrypt这类自适应哈希算法。如果你想让答辩老师眼前一亮可以直接不要用MD5SpringSecurity自带的BCryptPasswordEncoder是现成的加密后自动带盐无法反推成本只是多引入一个依赖。毕设建议不要省这个功夫安全也是系统的一部分。7.2 业务类问题权限、并发、扩展性老师除了问技术还会问业务场景问题因为要考察你是不是真懂这个系统解决什么问题。学生的权限是怎么限制的他能删自己下载的资料吗应答思路权限判断在两层做。第一层是接口层AuthInterceptor校验是否登录第二层是业务层比如删除接口里会判断material.uploader_id是否等于当前登录人ID不是则拒绝。学生这个角色本身就没有调用删除/上传接口的权限前端隐藏按钮、后端接口拦截两层一起保证。如果有100个学生同时下载同一个文件你的系统怎么办应答思路当前体量下静态文件由Nginx直接服务如果配置了alias或root指向文件目录加上操作系统的文件缓存压力不大。下载计数加1是每次请求一次update并发高了可以改造成先放内存队列或者Redis异步更新。这个回答充分说明你知道瓶颈在哪以及怎么演进。7.3 演示环节的避坑与话术演示是整个答辩的重头戏很多同学在代码上花了很多功夫却在演示时因为一个测试数据没准备好而留下坏印象。我建议你按这个清单来准备预置账号要准备好至少要有一个管理员账号、一个教师账号、一个学生账号密码写在演示文档里不用现场输入。测试数据要像样课程至少三个每个课程下至少三个资料文件名用《Java程序设计》第3章_泛型.pdf这种真实风格不要用111.pdf新建文档1.pdf。有辨识度的数据比代码更能直观展示系统价值。演示路径要设计过先讲背景和需求再讲架构图然后演示学生登录 → 浏览课程 → 搜索泛型 → 下载文件 → 退出 → 教师登录 → 上传新资料 → 下载次数变化。一条主流程走通中间不来回切换页面。导出报告页面要提前打开如果你的系统有下载量排行榜、课程资料统计这类页面演示时点到它们会让老师觉得你做了完整闭环。被问倒的时候怎么办我的建议是坦诚加思路。比如老师问如果服务器挂了怎么办你不会做高可用就如实说当前版本是单机部署后续可以考虑用Docker容器化加多副本部署前端用Nginx负载均衡。老师要的不是你真的实现过高可用而是看你有没有思考问题的意识和基本的技术视野。千万不要当场硬编一个你已经实现的功能被追问细节后反而更扣分。做这个系统我的个人体会是它难不在某个单点功能而在把所有环节串起来。后端接口写好了前端页面要能对接上本地能跑了服务器上还要能部署代码能跑了答辩时还要能讲清楚。每一个环节都是独立的能力但这个题目逼着你全部过一遍。等你完整走完这一轮再回头看你简历上写的那句熟悉SpringBoot后端开发就踏实多了——你是真的从头到尾造过一个能运行的系统。