做课程设计或者毕业设计,我见过太多人一上来就选“XX管理系统”,结果做着做着发现功能堆了一堆,代码却乱成一锅粥。如果你拿到的是“校友录管理系统”这个题目,并且已经确定用 Spring Boot,那这篇文章基本就是为你准备的。我按自己实际做项目的习惯,把这个系统的技术选型、数据库设计、核心功能实现、常见坑点全部过一遍,做成一篇直接能参考的实操笔记。
这套系统本身解决的问题很明确:把校友信息从纸质档案和Excel表里解放出来,做成一个可登录、可维护、可查询的Web应用。管理员可以管理班级和校友信息,普通用户(或者同样管理员)可以按班级、专业、入学年份去检索校友,也能维护工作单位、联系方式、近况动态这些字段。别小看这个题目,它几乎覆盖了 Spring Boot 入门阶段该学的所有东西:实体建模、ORM映射、分层开发、接口设计、异常处理、拦截器鉴权,认真做完一遍,你对 Java Web 开发的理解会扎实很多。
适合参考这套方案的读者有三类:一是正在做课程设计的学生,二是拿这个题目练手、想补全 Spring Boot 知识体系的开发者,三是需要快速交付一个可演示项目的同学。下面我按自己的实操顺序来讲,从设计思路一路说到部署,每个环节都会标注我踩过的坑。
1. 项目定位与设计思路拆解
1.1 校友录管理系统到底解决什么问题
很多同学拿到这种题目,第一反应是“把增删改查做出来就行”,这个想法没错,但容易做成低分项目。校友录管理系统的核心不是“能录入数据”,而是“让数据管理变得有意义”。我习惯先问三个问题:谁在用这个系统?他们有什么痛点?系统要做到什么程度才算好用?
在这个场景里,使用者通常是学校或院系的校友工作办公室,可能还包括班级联络人。他们的日常工作往往是维护历届毕业生名单、按班级统计校友去向、活动前发通知、整理校友捐赠信息。没有系统之前,这些数据分散在Excel、纸质登记表甚至微信群接龙里,整理起来非常痛苦。所以系统至少应该具备:统一的校友信息登记入口、分类检索能力、班级维度归组、导出或统计能力。
想清楚这一点之后,功能边界就不会跑偏。我这里把功能拆成几个模块:用户登录注册、班级管理(年级、专业、班级编号)、校友信息管理(基本信息、学历信息、工作单位、联系方式)、校友动态/留言、数据统计看板。如果你做的版本还想要加分项,可以加上管理员审核、图片上传头像、导出Excel。但是有一个原则:宁可核心功能做得精,不要所有功能都做得半吊子。
1.2 为什么选 Spring Boot 而不是其他框架
这是我在博客评论区和私信里被问得最多的问题。选 Spring Boot 的原因其实很实在:第一,生态成熟,网上参考资料极多,遇到问题基本能搜到答案;第二,内嵌 Tomcat,省去单独部署服务器的麻烦;第三,Spring 自带的 IOC/AOP 容器、Spring Data JPA 或者 MyBatis 的整合方式都很标准化;第四,这个方向在就业市场上有真实需求,学会 Sprng Boot 之后往微服务方向走也是一条顺路。
有人会问,那为什么不选 SSM(Spring + SpringMVC + MyBatis)?如果你的教学大纲或老师要求使用 SSM,那没问题。但我个人建议:除非有硬性要求,否则直接 Spring Boot。因为 Spring Boot 本质上是 Spring 生态的“自动配置”封装,你用 Spring Boot 写出的代码,底层仍然是 Spring MVC 那套机制,学 Spring Boot 并不耽误你理解 SSM。相反,SSM 里大量的 XML 配置会耗费很多时间,对课设来说性价比太低。
还有人会问:前端要不要前后端分离?我的建议是:课程设计级别不要强行上用 Vue + 分离式接口。原因很简单:前后端分离意味着你要同时维护两套工程、处理跨域、考虑 Token 认证,这些对初学者来说很容易卡住。用 Thymeleaf 或者直接把静态页面放到 src/main/resources/static 下,Spring Boot 默认托管,部署时打成一个 Jar 包就能跑,演示和答辩都方便。如果你是技术栈里已经会 Vue 的同学,也可以做成前后端分离,但这篇文章我按更稳妥的传统页面开发来讲。
1.3 源码、数据库、文档三个交付物意味着什么
拿到这个项目资源包的时候,你肯定会看到三个东西:源码、数据库(SQL脚本)、文档。这三个不是随便放进去的,它们正好对应了课程设计和毕设的三大评分维度:代码能力、数据库设计能力、文档表达能力。
源码部分要注意的是:你不应该只追求“能跑”,而是要让代码结构清晰、命名规范、注释适度。很多同学答辩时被问“这个功能怎么实现的”,答不上来,就是因为代码全是复制粘贴的,自己根本不熟。我后面会专门讲怎么逐层拆解源码。
数据库部分,通常是一份 .sql 文件,内含建库建表语句和基础测试数据。有这份脚本,意味着任何人在新环境里都能快速初始化数据库。我特别建议你把初始化数据写得丰富一点,比如每个班级放三五条校友记录,演示的时候随便搜一个关键词就有结果,视觉效果完全不一样。
文档部分一般包括需求说明、概要设计、数据库设计、核心代码说明、测试报告。写文档时不要大段抄代码,重点放在“为什么这么设计”和“核心流程怎么走”。比如你设计了一张 alumni 表,文档里要说清楚每个字段的业务含义、字段类型为什么这么选、哪个字段是外键、数据量大了之后怎么优化索引。这些内容才是阅卷老师真正想看的东西。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技术选型与版本搭配的讲究
2.1 Spring Boot 版本选择:2.x还是3.x
关于版本,我这些年被问过无数遍,尤其是“springboot版本太高”这个问题。很多人从网上下载的项目模板是 2.x 的,结果自己建项目时 IDEA 默认给你选了 3.x,然后发现 JDK 版本不匹配、javax 包变成 jakarta、各种配置失效,心态直接炸。
我的建议很直接:如果 JDK 是 1.8,那就老老实实用 Spring Boot 2.7.x;如果机器上装的是 JDK 17,那可以考虑 Spring Boot 3.0+。Spring Boot 3.x 强制要求 JDK 17,同时把 javax.servlet 等包迁移到了 jakarta.* 命名空间,如果你用的是旧教程,很多代码直接报红。对于课程设计这个场景,我通常推荐 Spring Boot 2.7.18,这个版本是 2.x 系列的最终维护版本,稳定、教程多,和 JDK 1.8 完美配合。
这里我用表格整理一下,方便你对照自己的环境选择:
| 环境组合 | Spring Boot版本 | JDK | 说明 |
|---|---|---|---|
| 老电脑/实验室 | 2.7.18 | JDK 1.8 | 最稳,网上资料最多 |
| 新电脑/最新IDEA | 3.2.x | JDK 17+ | 可以用,但遇到问题搜答案时记得加版本号 |
| 练习微服务方向 | 2.7.18 或 3.x | 视JDK而定 | 建议先不纠结版本,把基础做通 |
这里的核心原则是:学校要求什么用什么,优先兼容环境。不要为了追新版本而选 3.x,也不要在 JDK 17 的机器上硬装着 JDK 1.8 去跑 2.x,编译和启动时容易出现一些诡异问题。
2.2 数据库与连接方式选型
数据库方面,校友录管理系统最合适的还是 MySQL 5.7 或 8.0。MySQL 免费、资料多、图形化工具多,老师也熟悉。如果你机器的磁盘或内存比较紧张,SQLite 也可以,但考虑到后期扩展和管理方便,我还是建议 MySQL。
连接方式上,推荐用 MyBatis 或者 MyBatis-Plus。个人经验是:MyBatis-Plus 更省事,它内置了通用 Mapper,单表增删改查几乎不用写 SQL。但有些学校的教学大纲里要求“使用 MyBatis 手写 SQL”,那你就用纯 MyBatis。如果要体现自己的水平,可以混合使用:简单单表操作用 MP,复杂多表查询用自定义 SQL。
JDBC 驱动依赖版本也要注意。如果你用 MySQL 8.0,驱动类名是 com.mysql.cj.jdbc.Driver,依赖坐标是 mysql:mysql-connector-java,推荐用 8.0.x 版本。如果用 5.x 的驱动连接 MySQL 8.0 的数据库,也能连,但可能遇到时区报错或者认证插件不兼容的问题。
2.3 开发工具与前端方案
开发工具就用 IntelliJ IDEA,社区版够用,如果你有教育免费授权就用 Ultimate。前端方案我分两种情况:
一是用 Thymeleaf 服务端渲染。Spring Boot 对 Thymeleaf 支持是原生的,页面里
