每年到这个时间点总有一批同学开始为毕设和课设发愁。选题没定、项目跑不起来、答辩怕翻车。如果你正在找的是那种“既能当课设交差、又能写进简历、还能真正理解全栈开发流程”的项目那么 SpringBootVueMySQL 这套组合下的档案管理系统可能是目前最稳妥的选择之一。这套项目虽然叫“管理系统”但它的业务覆盖相当典型档案的新增、分类、借阅、归还、日志审计前后端分离的架构里塞满了增删改查、文件上传下载、权限控制、分页搜索这些基本功。无论你是用它来应付毕业设计还是当作学习 Java 全栈开发的练手材料都能在较短周期内跑通完整链路。这篇文章我就从实际开发的角度把档案系统的功能拆解、技术选型逻辑、数据库设计思路、前后端落地方案、本地复现步骤以及答辩加分项一次性讲清楚。1. 档案管理系统先想清楚业务边界再说写代码很多学生拿到“档案管理系统”这个题目后第一反应是打开 IDE 写代码结果写了两周发现逻辑混乱老师一问就露怯。正确的顺序应该是先把业务聊明白——技术永远服务于业务尤其答辩时老师一定会从业务逻辑切入提问。1.1 核心业务对象档案文件的生命周期档案管理系统本质上管理的是“档案文件”的完整生命周期。你想一下一个组织里真正发生了什么事有人产生了一份文件比如合同、学历证明、项目文档需要登记编号并存起来别人要用的时候需要申请借阅、审批通过、拿到文件、用完归还中间谁碰过这份档案、做过什么操作系统要留痕。把这个过程拆成状态就是一条非常清晰的链路建档 → 在库 → 借出 → 归还 → 归档/销毁。档案的 status 字段在数据库里就是对应这几个状态值。很多初学者会把档案管理做成简单的增删改查其实你没有把“状态流转”做出来业务就少了一大块答辩时也缺少亮点。1.2 功能模块清单一个标准管理系统该有的样子面向用户和答辩要求至少需要以下模块登录认证模块基于 JWT 的账号密码登录区分管理员和普通用户。用户管理模块用户的增删改查、角色分配、启用禁用。管理员可用普通用户不可见。档案分类模块对档案做分类维护比如按部门、按文档类型、按重要程度分类树或扁平分类均可。档案管理模块档案录入含文件上传、编辑、删除、详情查看列表支持按关键词搜索和分页浏览。借阅管理模块发起借阅申请 → 管理员审批 → 借出 → 归还 → 超期标记。操作日志模块记录谁在什么时间做了什么操作比如登录、删档、审批借阅给审计留证据。这 6 个模块做下来你的系统在功能完整性上已经超过大部分学生作品了。再加一点深度比如借阅到期自动提醒、档案批量导入那就属于加分项后面专门讲。1.3 为什么“档案管理”适合做毕设/课设选这个题最关键的原因是业务复杂度适中。它不像电商系统那样有购物车、订单状态机、支付回调一堆麻烦事也不像“校园二手交易”那样用户角色太单一。档案管理天然有“管理员-普通用户”的双角色模型、有“档案-借阅记录-操作日志”的多表关联还有文件流的上传下载几乎覆盖了 Java 后端和 Vue 前端所有核心知识点。而且这类管理系统是 Java 企业开发里最典型的需求形态——内部业务系统占了真实工作里很大的比例。你做完它技术栈与真实项目是匹配的写在简历上不会显得虚假。2. 黄金三角为什么这套技术栈是毕设的稳妥选择如果单纯为了交作业你完全可以用 JSP Servlet JDBC 写一个能跑的旧式系统。但如果你对自己的要求是“毕业设计拿得出手、找工作面试能聊技术”前后端分离的 SpringBoot Vue MySQL 就是当下最匹配的选择。2.1 三个组件各解决什么问题SpringBoot后端应用框架内嵌 Tomcat不用打 war 包、不用配置一堆 XML。它提供的自动装配、Starter 机制让开发者把精力集中在业务代码上。对初学者来说学习曲线比传统 SSM 平缓得多。Vue前端渐进式框架核心是组件化和响应式数据绑定。页面由一个个组件拼装而成数据变了界面自动更新不用手动操作 DOM。MySQL关系型数据库存储一切业务数据。之所以选它不选 Oracle是因为 MySQL 免费、社区资料多、安装配置简单而且绝大多数公司的业务系统后端存储就是 MySQL。这三个组合起来就是标准的“前后端分离”开发模式前端用 axios 调后端 RESTful API后端返回 JSON前端渲染页面。2.2 为什么不推荐其他组合你可能在B站和CSDN上看到大量 JSP 项目比如 SSM 框架 JSP 的图书管理系统。这类项目的问题在于JSP 页面由后端渲染前端代码和后端 Java 代码混在一起页面样式陈旧API 概念也很弱放到简历上基本是减分项。而 Vue 你可以理直气壮地写“熟悉前后端分离开发模式”这是当前企业主流协作方式面试官更认可。另外也有同学纠结用 Vue 2 还是 Vue 3。我的看法是如果你的 Project 源码是基于 Vue 2 的完全不需要焦虑企业里 Vue 2 存量项目非常庞大用 Vue 2 跑通反而能让你在处理 Element UI 组件库生态时更顺手。如果你是从零开始自己搭那优先选 Vue 3 Vite Element Plus。2.3 环境版本选型这步错了全是眼泪版本不匹配是新手项目中报错的第一来源。推荐下面这套稳定组合组件推荐版本说明JDK1.8 或 11毕设绝大多数用 JDK 8 最稳Spring Boot 2.x 系完全兼容Maven3.6配好阿里云镜像依赖下载速度差好几倍Spring Boot2.7.x稳定、教程多避免直接用 3.x 引入兼容问题MySQL5.7 或 8.0注意驱动和连接串的差异8.0 要加useSSLfalseNode.js14 或 16别用最新的 20老项目 npm install 容易报错Vue2.6 / 3.x跟随项目源码走通常配套 Element UI 或 Element Plus安装本身不是难点网上教程一堆重点提醒一句Node 的版本管理一定要用 nvm不要图省事装一个固定版本就完事。多个项目对 Node 版本要求不同用 nvm 随时切换能少流很多泪。2.4 前后端项目目录结构约定后端src/main/java下按controller、service、mapper、entity、config、common分包src/main/resources下放application.yml和mapper的 XML 文件。前端src/api放接口请求封装src/router放路由配置src/views放页面组件src/components放公共组件src/utils放 axios 实例和工具函数。这个结构是行业通用约定你以后进公司看到的项目大概率也是这个味道提前养成习惯。3. 数据库是一切的根档案系统的表设计思路很多学生喜欢上来就写实体类然后让 MyBatis-Plus 自动建表。这个做法放到学习项目里风险很大——你很难控制字段类型、索引和默认值而且答辩时老师很爱问“你这几个表为什么这么设计”。这一节我把核心表结构展开讲透。3.1 五张核心表的结构说明用户表user字段包括id、username唯一、passwordBCrypt 加密存储、real_name、roleadmin/user、department、status启用/禁用、create_time。密码为什么必须加密数据库一旦泄露明文密码就是安全事故。用 Spring Security 的 BCryptPasswordEncoder 或者 Shiro 的加密工具一次性密码哈希不要用 MD5 这种可逆方案。档案分类表archive_category字段包括id、category_name、parent_id、sort_order。parent_id为 0 表示顶级分类支持无限层级扩展。档案表archive这是核心中的核心。字段包括id主键。archive_no档案编号唯一索引比如DA-2024-0001。title档案标题。category_id外键逻辑关联分类表。file_path文件在服务器上的存储路径不存二进制。status在库/借出/已销毁。upload_user_id上传人。remark备注。create_time、update_time。注意档案表的file_path只存路径字符串真正文件放在服务器磁盘目录里。这样数据库体积小、备份快文件读写也灵活。借阅记录表borrow_record字段id、archive_id、borrow_user_id、borrow_time、expect_return_time、actual_return_time、status待审批/已通过/已驳回/已归还/已逾期、audit_user_id、audit_time。这张表是档案系统的“关系核心”它同时关联档案表和用户表代表业务中最有价值的流转过程。答辩时把这张表讲透就能证明你真的理解了业务。操作日志表operation_log字段id、user_id、action比如 ADD、DELETE、LOGIN、target_type操作对象类型、target_id、detail描述、ip、create_time。3.2 表关系的梳理一个分类下有多份档案一对多一份档案对应多条借阅记录一对多一个用户有多条借阅记录和操作日志一对多。没有多对多关系所以不需要额外的关联中间表整个模型非常清晰。有一点必须强调不要用物理外键。也就是不在数据库层面写FOREIGN KEY约束而是在代码的 Service 层做逻辑校验。原因很实际物理外键会导致插入、删除时频繁报错造测试数据也容易卡壳而且真实企业项目为了高并发写入性能普遍废弃物理外键。你把逻辑外键讲明白老师会觉得你有工程经验。3.3 索引与种子数据保证查询性能和开箱即用archive_no建唯一索引category_id、borrow_record.archive_id、operation_log.user_id建普通索引。如果你的数据量增长到几十万条这些索引的效果会非常明显。种子数据就是初始数据。你要在 SQL 文件里预置一个管理员账号如admin / admin123当然密码存的是 BCrypt 密文以及 20 条左右的示例档案记录和 5 条左右借阅记录。这样别人拿到源码导入 SQL 后直接就能登录看到页面数据不用从头填写体验完全不一样对你在 GitHub 开源项目或者课程设计展示来说也重要。4. 后端 SpringBoot分层、鉴权、文件上传里最容易被问透的细节后端是面试和答辩的“主战场”。这个项目里的后端代码量不大但每一块都有值得深挖的知识点。4.1 Controller-Service-Mapper 三层架构怎么分才不显得业余分层原则很简单Controller 只接收参数和返回结果Service 只写业务逻辑Mapper 只做数据库操作。然而很多同学的代码长这样Controller 里直接注入 Mapper然后一个方法 200 行事务也没有参数校验也没有——这就是典型的“学生代码”。正确的做法是Controller 里做参数绑定、调用 Service、把结果放进统一返回体。不要写任何 SQL 相关的东西。Service 里做业务判断比如借阅审批时检查档案是否在库、用户是否到期未还以及必要的事务控制Transactional。Mapper 层用 MyBatis 或 MyBatis-Plus 操作数据库复杂的 SQL 写在 XML 里简单的单表操作直接用 Plus 的方法。额外提醒Service 层接口和实现类分开写也就是BorrowRecordService接口 BorrowRecordServiceImpl实现类。这是 Java 企业开发的传统约定也是 Spring 面向接口编程思想的直接体现。4.2 JWT 登录鉴权的完整链路与白名单设计这个项目的登录鉴权推荐直接用 JWTJSON Web Token而不是传统的 HttpSession。原理一句话说清用户登录成功后后端生成一个加密的 token 串里面包含用户 ID、角色、过期时间返回给前端前端每次请求都把 token 放在Authorization请求头里后端用一个拦截器或过滤器把所有请求拦下来先验证 token 合法性再放行。具体实现要点登录接口/api/auth/login接收用户名密码校验成功后用jjwt或hutool的 JWT 工具生成 token。写一个JwtInterceptor实现HandlerInterceptor在preHandle中从请求头取 token解析失败则返回 401。注册拦截器时指定白名单比如/api/auth/login、静态资源路径、/error等。除此之外的所有接口都要过 token 校验。用户信息怎么传给后面的业务代码解析 token 后把用户对象放到ThreadLocal或request属性里后续 Service 直接从上下文拿当前登录人。为什么用 JWT 而不是 Session一句话回答是前后端分离架构下前端可能部署在另一个端口或域名Session 需要处理跨域 Cookie、服务端要维护会话状态而 JWT 是自包含的服务端可以做成无状态扩展到多实例部署时不需要共享 Session 存储。这个答案在面试里也是标准答案。4.3 文件上传下载的落地细节与路径穿越防线档案系统的核心特色就是档案文件本身。文件上传接口长这样PostMapping(/api/archive/upload) public RString upload(RequestParam(file) MultipartFile file) { // 1. 校验文件大小、扩展名 // 2. 用 UUID 生成新的文件名保留原扩展名 // 3. 保存到配置的存储目录 // 4. 返回相对路径给前端与档案表单一起提交 }这里有几个必须处理的点文件大小限制在application.yml里配置spring.servlet.multipart.max-file-size和max-request-size比如 10MB / 50MB。文件名重命名文件名不要用用户原始文件名否则会发生中文乱码和重名覆盖问题。用UUID.randomUUID().toString() 扩展名最省心。路径穿越攻击用户可能传入../../etc/passwd这种文件名。如果你直接拼接路径后果很严重。用 UUID 后这个风险自动消解但如果你要保留原始文件名必须做路径规范化校验拒绝包含..的路径。下载接口更简单根据档案 ID 查询file_path用ResponseEntityResource或InputStreamResource将文件流返回前端。这里也要注意设置Content-Disposition为attachment让浏览器触发下载。4.4 统一返回体与全局异常处理工程化代码的标志后端所有接口都返回统一 JSON 结构。自定义一个RT类public class RT { private Integer code; // 200 成功4xx/5xx 失败 private String msg; private T data; }再加上一个RestControllerAdvice全局异常处理器集中捕获业务异常、参数校验异常、未知异常。这么做的价值是前端 axios 拦截器只需要看code字段就能决定是弹成功提示还是错误提示不用每个接口单独判断状态码。这是真实项目的标配也是答辩时一个非常容易拿分的点。5. 前端 Vue组件拆分、路由守卫和接口封装的实际写法前端部分的核心不是你“会写标签和样式”而是你能不能把一个页面拆成合理的组件树能不能把接口请求统一管理起来。我按实际开发顺序来讲。5.1 组件树怎么拆别把所有代码塞进一个文件一个合格的档案系统前端页面分为以下几块Login.vue登录页登录成功后跳转到首页。Layout.vue整个系统的主框架左侧侧边栏菜单、右侧内容区。侧边栏菜单要根据角色动态渲染比如管理员能看到用户管理菜单普通用户看不到。ArchiveList.vue档案列表页含搜索表单、表格、分页组件。ArchiveForm.vue新增/编辑档案的弹窗表单含分类选择器、文件上传控件。BorrowRecord.vue借阅记录页面区分“我发起的”和“我审批的”两个 Tab 页。CategoryManage.vue分类管理页面。LogList.vue操作日志页面只读。组件拆成这样每个文件保持在 300 行以内逻辑清楚想扩展功能也方便。答辩时老师问“你这个系统怎么组织前端的”你就把组件树图画出来一讲印象分直接拉满。5.2 嵌套路由和守卫怎么防止未登录的人乱闯用 Vue Router 的嵌套路由配置 Layout 和子页面的关系const routes [ { path: /login, component: Login }, { path: /, component: Layout, redirect: /archive/list, children: [ { path: archive/list, component: ArchiveList, meta: { title: 档案列表 } }, { path: borrow/list, component: BorrowRecord, meta: { title: 借阅管理 } }, { path: system/user, component: UserManage, meta: { title: 用户管理, roles: [admin] } } ] } ]路由守卫的核心作用每次路由跳转前检查 token 是否存在不存在就强制跳到登录页如果目标页面有meta.roles限制还要检查当前用户角色是否匹配。router.beforeEach((to, from, next) { const token localStorage.getItem(token) if (to.path /login) return next() if (!token) return next(/login) next() })这段代码是每次前端面试都会被问到的“路由守卫”你写在项目里面试时能直接拿来演示。5.3 axios 封装请求拦截器里加 token响应拦截器里统一处理错误不封装的 axios 用法是每个组件里this.$http.get(/api/xxx)一旦 token 过期或者后端返回自定义错误每个组件都要处理一遍代码重复且容易漏。正确的封装方式const service axios.create({ baseURL: /api, timeout: 10000 }) // 请求拦截器注入 token service.interceptors.request.use(config { const token localStorage.getItem(token) if (token) { config.headers[Authorization] Bearer token } return config }) // 响应拦截器统一处理 code service.interceptors.response.use(res { const { code, msg, data } res.data if (code 200) return data if (code 401) { localStorage.removeItem(token) router.push(/login) } // 其他错误统一弹提示 return Promise.reject(new Error(msg || 请求失败)) })开发环境下跨域问题怎么解决要么后端写 CORS 配置要么前端在vue.config.js里配 devServer 的 proxy 代理。推荐用 proxy因为部署上线时也是通过 Nginx 代理后端接口前后端在同一个域名下天然规避跨域。5.4 表格 表单 分页列表页的标准写法列表页核心逻辑是四件事搜索条件、分页数据、表格渲染、操作按钮。我建议画一个清晰的流程页面加载时调用getArchiveList(currentPage, pageSize, keyword, categoryId)。后端返回{ total: 100, rows: [...] }前端把 total 给分页组件。用户点击搜索或切换页码时用新的参数重新调用接口。表格里每一行的编辑和删除按钮编辑会打开弹窗表单删除需要二次确认弹窗防止误删。Element UI 或 Element Plus 提供现成的el-table、el-pagination、el-dialog、el-form组件。你用起来顺畅代码也整洁。有一点要注意表单校验规则必须写完整。比如档案标题必填、档案编号必填且唯一、分类必选。后端也要做同样的校验。永远不要相信前端传来的数据是干净的这是一条铁律。6. 本地复现全流程从环境准备到前后端联调的避坑记录这一节我按“拿到一份 SpringBootVue 档案管理系统源码后怎么在你自己电脑上把它跑起来”来写。全程都是实操步骤跟着走就行。6.1 环境准备清单先把地基搭好JDK 8安装后配置JAVA_HOME环境变量在命令行执行java -version验证。Maven 3.6配置settings.xml把镜像换成阿里云mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirrorMySQL 5.7/8.0安装时记住 root 密码。8.0 版本如果连接报Public Key Retrieval is not allowed在 JDBC URL 后面加allowPublicKeyRetrievaltrue。Node.js 16建议用 nvm 管理。安装后执行node -v和npm -v确认版本正常。6.2 导入数据库和修改配置用命令行或 Navicat 执行项目提供的 SQL 脚本mysql -u root -p archive_system.sql然后确认数据库列表里出现了archive_system库和所有表。接下来改后端配置spring: datasource: url: jdbc:mysql://localhost:3306/archive_system?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: 你的密码 servlet: multipart: max-file-size: 10MB max-request-size: 50MB file: upload-dir: D:/upload/archive # 改为你本机实际目录6.3 启动后端与前端后端启动方式有两种一是在 IDEA 里直接打开项目等待 Maven 依赖下载完成后运行主类ArchiveApplication.java二是命令行执行mvn spring-boot:run。看到 Spring Boot 启动成功、端口 8080 监听的日志就说明后端起来了。前端启动命令cd frontend npm install # 如果报错就 npm install --registryhttps://registry.npmmirror.com npm run dev # 启动开发服务器浏览器访问http://localhost:8080或http://localhost:3000看项目配置用种子数据里的管理员账号登录能进主页就说明联调成功。6.4 常见报错自查清单报错现象大概率原因解决动作前端请求接口返回 404代理配置没生效或接口路径写错检查vue.config.js的 proxy 和 axios baseURL返回 401token 缺失或过期重新登录检查请求拦截器是否注入 token后端日志报Communications link failureMySQL 没启动或连接串配置错误检查 MySQL 服务状态、账号密码、端口npm install报 ERESOLVENode 版本过高/过低用 nvm 切到 Node 14/16MyBatis-Plus 实体映射字段为 null驼峰映射没开启配置map-underscore-to-camel-case: true7. 答辩加分与自学进阶把这些扩展点准备好代码就真正长在你身上了从“跑通源码”到“项目是自己的”中间隔着几个扩展点。我建议你在完成基础功能后挑一两个方向做深这既是答辩的亮点也是你面试时能讲的“增量”。7.1 批量导入档案用 EasyExcel 处理 Excel 上传档案系统有一个很真实的需求用户手头有几百份档案信息已经在 Excel 里系统里一条条录不现实。追加一个批量导入功能前端上传 Excel后端接住后用EasyExcel解析成对象列表逐条校验标题非空、编号不重复、分类存在然后批量插入数据库。这个扩展点覆盖了大文件解析、数据校验、批量插入三个知识点。学会后你还能举一反三用在任何管理系统的导入功能上。7.2 全文检索从 LIKE 到更优方案默认列表搜索用LIKE %关键词%实现数据量小没问题数据量大时索引会失效全表扫描很慢。你可以先说这个方案的问题然后给出优化思路短字段如档案编号用前缀索引LIKE 关键词%可以走索引。标题和备注字段用 MySQL 全文索引或引入 Elasticsearch 做全文检索这个作为进阶方案面试时可以讲思路毕设不一定要求真做。分页本身一定要做不要一把梭把全表查出来在内存里过滤。7.3 操作日志审计AOP 自定义注解日志模块如果是在每个方法里手动调日志 service代码不仅丑还容易漏记录。用 Spring AOP 定义一个Log注解标注在任何 Controller 方法上然后写一个切面在执行方法前后记录操作人、动作、参数、耗时。这样你想记录哪些操作只需在方法上加一个注解非常优雅。Aspect Component public class LogAspect { Around(annotation(log)) public Object around(ProceedingJoinPoint pjp, Log log) throws Throwable { // 记录开始时间、解析操作人、方法参数 Object result pjp.proceed(); // 执行原方法 // 记录结束时间、动作、保存日志 return result; } }这个实现是“基于注解的日志框架”的经典写法面试时聊到日志监控你可以直接把它抛出来。7.4 数据权限不同部门只能看本部门档案当前系统只有管理员和普通用户两种角色。再扩展一层“部门”管理员能看到全部普通用户只能看本部门上传的档案。实现不复杂在档案表加department_id字段查询时 Service 里根据当前登录人的部门拼接条件。这个点讲到“数据权限”的实体隔离方案体现的是你对业务权限模型的理解深度。7.5 性能与部署从开发环境到生产环境把项目从一个“开发演示”的水平拉高还有几个常规操作文件存储从本地磁盘换成 MinIO 或阿里云 OSS便于备份和扩展。Nginx 部署前端静态文件用反向代理转发/api请求到后端彻底解决跨域。后端打成 jar 包用systemd守护运行日志重定向到文件并按天切割。这些事情如果你都亲手做过一遍简历上写“熟悉项目部署上线流程”时心里是有底的。最后说点我个人的体会。像档案管理系统这样的全栈项目网上源码非常多难点从不在“跑起来”而在于你能不能把每张表、每个接口、每个弹窗背后的为什么讲清楚。我见过很多同学把代码部署成功截图发给老师就算完事结果答辩时被一句“借阅状态流转在哪里处理的”问得哑口无言。我的建议是拿到源码后先对着数据库表结构把业务捋一遍再顺着一个请求从点击按钮到 SQL 执行走一遍完整链路——这个过程做完这个项目才是真正长在你身上的东西。你要是能再动手改一个模块收益远比刷十套面试题管用。
