Pinxian Li如果你今年正在准备计算机类毕业设计，又想找一个既能体现 Java 后端功底、又能完整体现业务闭环的方向，那么“基于 Spring Boot + 小程序的高校校友会系统”是一个性价比很高的选题。校友会系统不偏门，但也不像商城、点餐那样被做到烂大街，它包含校友企业管理、母校要闻管理、校园风景管理、班级信息管理、活动类型管理等完整业务模块，既有后台管理端，又有校友使用的小程序端，非常适合做前后端分离的项目展示。这篇文章我就把自己从选题、设计、编码到部署的完整过程整理出来，给正在做类似项目的同学一个真实可落的参考。
1. 毕设选题时的真实考量：为什么是校友会系统
我先说说当时是怎么定下这个题目的。选毕设题目最怕两件事：一是题目太虚，业务逻辑全靠编，做完自己都不知道做得对不对；二是题目太常规，答辩老师一眼看完，问不出深度问题，你的工作量也会被打折扣。校友会系统恰好处在中间：业务场景清楚，数据模型不算复杂，但又混着校企合作、活动报名、班级管理这些“有得聊”的细节，改动空间非常大。
高校学院的校友会，核心服务对象是已经毕业的校友和学院内部的管理人员。校友需要回母校看看、查班级通讯录、报名活动、了解母校新动态；管理员需要维护校友档案、关联校友企业、发布新闻、管理活动类型。这样的场景落到系统里，就会自然拆出标题里的几个模块：校友企业管理、母校要闻管理、校园风景管理、班级信息管理、活动类型管理。每个模块之间不是孤立存在的，而是通过校友、班级、活动这些实体互相串联，这种关联关系正是答辩时最容易展示设计思路的地方。
另外，从工作量上看，这个题目很合适。后端用 Spring Boot，小程序端用原生框架或者 uniapp 都能撑起来，前后端接口数量大概在三十到五十个之间。如果你还想继续拓展，可以加权限管理、数据统计、消息推送，工作量丰俭由人。如果打算用现成源码二次改造，这个题目也能让你的个性化改动非常明显，比如换一套校园风景展示样式、加一个校友企业名片二维码，都很容易在答辩时解释清楚。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 系统拆解：五大核心模块背后的业务逻辑
很多人拿到题目就开始建表写接口，但我觉得先理解每个模块的实际业务比写代码更重要。我按实际开发顺序把这五个模块捋一遍，看看它们到底要解决什么问题。
2.1 校友企业管理模块
这个模块实际上是整个系统的基础数据源。校友注册或者管理员录入校友信息后，系统需要保存姓名、性别、入学年份、所在班级、工作单位、职位、联系方式等。这里的“企业”并不是单独给校友列表多做一个企业表，而是要体现出校友与企业之间的关系。我当时的做法是：校友表里冗余一个当前公司名称和职位字段，再单独建一张校友企业表记录多次就业经历，这样既保证首页列表查询效率，又能满足“查看某个校友的企业履历”这类细颗粒度需求。
如果做二次开发，这块还可以加入校友活跃度标签、地区分布统计。我在实际设计时，给校友表加了一个字段叫“校友状态”，用来区分“在校生、已毕业、校企合作顾问”等身份，后续做活动通知、分类筛选时特别方便。
2.2 母校要闻管理模块
要闻模块对应的就是学院官网或者公众号上的新闻。管理员在小程序后台编辑标题、配图、正文，小程序首页就能拉取最新的新闻列表。要注意的是，要闻不只是给校友看的，它还要承担系统冷启动时的内容填充任务，所以后台的编辑器必须支持富文本，至少支持图片粘贴和排版。
我在做这个模块时偷了个懒，没有自己实现富文本组件，而是接了一个常用的富文本库，后端只负责存 HTML 字符串。这样小程序端用 rich-text 组件就能直接渲染，省去了解析 Mardown 或自定义标签的麻烦。这是一个比较务实的做法，适合毕设阶段控制开发量。
2.3 校园风景管理模块
校园风景管理的本质是“图片+文字说明+上传时间”的简单内容管理。但它在小程序端的展示形式可以做得比较有亮点，比如首页顶部轮播图展示校园风景，或者单独做一张瀑布流页面。考虑到小程序包体积和服务器带宽，我在后端接口里支持了图片压缩参数，管理员上传原图后，系统会生成多个尺寸的缩略图，列表页用缩略图，详情页用原图。
这个模块的难点不在 CRUD，而在图片存储。毕设项目用阿里云 OSS 或者本地上传都可以，如果图方便，直接把图片存到服务器磁盘、数据库存访问路径也行。我一开始用的就是本地上传，在小程序开发阶段配合内网穿透工具测试，后来部署到云服务器后再换成对象存储，两步走比较稳妥。
2.4 班级信息管理模块
班级信息是连接校友和活动的重要桥梁。校友按班级归档，校友会发起班级聚会活动时，需要按班级维度群发通知。班级表里记录学院、专业、楼层（高校一般是学院下设系、系下设班级）、入学年份、毕业年份、班主任等。这样在校友表里只需要记录班级 ID，就能通过班级查出同一个年级或者同一个专业的校友集合。
这个模块的设计有一个容易忽略的点：校友毕业后班级信息可能因为院系调整而变化，所以班级表最好加一个“是否有效”字段，而不是直接删除。有些老班级的数据需要保留，只是不再显示在新名单里。我在做数据初始化时还顺手写了导入 Excel 的功能，用 EasyExcel 批量导入班级和校友，给管理员省了很多手工录入的时间。
2.5 活动类型管理模块
活动类型管理是相对独立但又能体现“系统配置能力”的模块。校友会会组织返校日、企业宣讲、技术沙龙、校友捐赠等活动，每一种活动类型可能对应不同的报名表单和展示样式。我把活动类型做成字典表，活动主表只存类型 ID，小程序端根据类型 ID 展示对应的图标和颜色。
如果你想让系统看起来更“智能”，还可以在活动报名时加上人数限制和截止时间，并通过微信订阅消息通知报名结果。我在实际项目里加了简单的报名人数校验，活动表里写入 max_people 和 current_people 两个字段，在当前人数达到上限时接口返回友好提示。这种业务规则不复杂，但能给答辩加分不少。
3. 技术选型与工程搭建：Spring Boot 加小程序的前后端分离实践
3.1 后端为什么选择 Spring Boot 加 MyBatis-Plus
后端框架选型几乎没有悬念：Spring Boot 2.x + MyBatis-Plus + MySQL 是最稳妥的组合。Spring Boot 帮你把配置化繁为简，MyBatis-Plus 直接把单表 CRUD 简化到极致，尤其在写那些重复的 selectByMap、insert 时有很强的效率优势。我用的版本是 Spring Boot 2.7，搭配 MyBatis-Plus 3.5，JDK 用 1.8，保证市面上所有云服务器都能直接跑。
说一下我的看法：有些同学喜欢用 JPA，毕设也确实能写，但 JPA 在处理多表关联查询时没有 MyBatis 直观，后期想调 SQL 也比较别扭。MyBatis-Plus 可以在 mapper 里直接写注解 SQL，也可以写 XML，我更喜欢把动态 SQL 写在 XML 里，因为排查问题的时候直接复制到数据库客户端里执行即可，错误出现时能快速定位。
工程结构我按常见规范来分：Controller 层接收参数、Service 层处理业务、Mapper 层操作数据库，再用 DTO/VO 对象做参数校验和响应封装。不要图省事把业务逻辑堆在 Controller 里，后期答辩时老师扫一眼代码结构就知道你有没有工程素养。
3.2 小程序端：原生小程序与 uniapp 的选择
小程序端我最终选了原生微信小程序。理由是项目只需要在微信端运行，不要求跨多端；原生小程序的 WXML、WXSS 和 JS 逻辑足够清晰，而且微信开发者工具直接能调试、真机预览也方便。如果你想要同一套代码跑支付宝、抖音小程序，可以用 uniapp，但这会引入 HBuilderX 构建这层工作量，对毕设来说并不划算。
小程序的目录结构我按模块来组织：pages/index 放首页，pages/alumni 放校友列表，pages/clazz 放班级信息，pages/activity 放活动列表和详情，pages/my 放个人中心。网络请求单独封装在 utils/request.js 里，统一管理 BaseURL 和 token；图片上传统一走 uploadFile 接口，这样能够避免在多个页面里反复写重复代码。
3.3 前后端接口约定与联调方式
前后端分离项目最重要的一步是接口约定。我先用 RESTful 风格定义资源接口，比如 /api/admin/alumni、/api/admin/news、/api/mini/activity/list。状态码统一用 200 表示成功，业务异常用自定义响 应体里的 code 字段区分，比如 400 参数错误、401 未登录、500 系统异常。这样做的好处是，小程序端不用关心 HTTP 状态码和业务码的映射，只用判断 res.data.code 就能决定弹窗还是跳转。
接口文档我建议用 Apifox 或者 Postman 先跑一遍，把每个接口的入参和返回体固定下来，然后再去写前端页面。联调时直接把后端服务跑在局域网 IP，小程序的请求地址填 http://192.168.x.x:8080/api，在开发工具里勾选“不校验合法域名”，就能一边改代码一边看效果。等上线时再换成 HTTPS 域名，这样开发效率最高。
4. 数据库设计要点：校友、班级、活动的关联关系处理
数据库设计是整个项目的骨架，我在这里花的时间和编码时间几乎对半。我先是画出 ER 图，再建表，最后才写接口。按照标题里的模块，核心表可以分成两个层次：基础数据表（校友、班级、企业）和业务数据表（要闻、风景、活动、活动类型）。
4.1 核心表结构说明
下面给出几张关键表的字段设计思路，不贴完整 SQL，但字段名和类型足够你直接建表使用。
校友表 alumni 的重点字段：
id：主键，自增clazz_id：班级 ID，外键关联班级表name、gender、phone、emailcompany、position：当前所在企业及职位graduate_year：毕业年份status：校友状态（1 已毕业，2 在校生）avatar：头像地址create_time、update_time：统一时间字段
校友企业表 alumni_company 的核心字段：
id、alumni_idcompany_name、company_positionstart_date、end_datedescription：企业对校友工作的简要描述
班级表 clazz 的重点字段：
id、namecollege、major：学院和专业grade：年级，比如 2018 级monitor：班长姓名is_active：是否有效
活动表 activity 的重点字段：
id、title、type_id：关联活动类型表cover、contentstart_time、end_timeaddressmax_people、current_peoplestatus：活动状态（0 未开始，1 报名中，2 已结束）
活动报名表 activity_signup 的重点字段：
id、activity_id、alumni_idsignup_timeremark：报名留言
要闻表 news 和风景表 scenery 字段比较简单，基本是 title、cover、content、sort、create_time。需要注意的是 sort 字段，用于前端排序，管理员可以手动拖拽，操作上特别有用。
4.2 关联关系的设计思路
校友与班级是多对一，班级与学院是一对多，校友与企业是一对多。在数据库里，我采用“在子表保存父表 ID”的常规方式，避免中间表造成查询困扰。比如校友表保存 clazz_id，校友企业表保存 alumni_id，查询某个校友的信息时，先查校友表拿到班级 ID，再带出班级名称。
活动报名是典型的多对多关系，因为一个校友可以参加多个活动，一个活动也会有多个校友报名，所以必须建中间表 activity_signup。我在这里做了一个小优化，在中间表加了一个唯一索引（activity_id + alumni_id），防止重复报名。这是一个很细的数据库设计点，但答辩时拿出来讲，会显得你在并发场景上思考过问题。
4.3 时间字段和逻辑删除的规范
所有业务表都统一加 create_time 和 update_time 字段，并且使用 datetime 类型。每个表都加 deleted 逻辑删除字段，MyBatis-Plus 里通过 @TableLogic 注解自动实现删除转更新。这样做最大的好处是，管理员误删校友时还能从数据库里恢复，不需要做物理删除。
如果担心数据库时间字段在插入时没有值，可以通过 MyBatis-Plus 的自动填充功能，在实体类字段上加上 @TableField(fill = FieldFill.INSERT) 注解，然后在配置类里实现一个 MetaObjectHandler，每次插入时自动写入 LocalDateTime.now()。这样代码里永远不用手动 set 时间字段，减少很多样板代码。
5. 后端开发中的关键接口与权限控制
后端按业务模块分好包之后，我建议先做管理员登录和微信登录，因为它们决定了其他所有接口是否走鉴权。校友会系统有两个端：后台管理端给管理员用，小程序端给校友用。我采用 Token 作为身份凭证。
5.1 管理员登录接口与 JWT 鉴权
管理员登录接口接收账号和密码，密码用 BCrypt 加密存储，校验通过后生成 JWT token。返回 token 的同时也返回管理员的昵称和角色标识，小程序端把它存在本地，后续请求在 Header 里带 Authorization: Bearer token。
我用一个拦截器统一做 token 校验，拦截所有 /api/admin/** 路径。校验失败时返回 401，并在响应体里说明“登录状态已过期”。关键实现如下：
java复制@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void addInterceptors(InterceptorRegistry registry) {
registry.addInterceptor(adminTokenInterceptor())
.addPathPatterns("/api/admin/**")
.excludePathPatterns("/api/admin/login");
}
}
需要注意，拦截器里如果直接读取 token，可能会有空指针问题。我当时先判断 request.getHeader("Authorization") 是否为 null，再判断前缀是否以 “Bearer ” 开头，最后才解析 JWT，三个条件都需要处理，缺一个就会出现诡异的 500 错误。
5.2 校友列表分页查询接口的实现示例
校友列表是小程序端最核心的接口，必须支持分页、搜索、按班级筛选。接口参数包括 page、size、keyword、clazzId。Service 层用 MyBatis-Plus 的 LambdaQueryWrapper 动态拼接查询条件。核心代码如下：
java复制public PageResult<AlumniVO> pageAlumni(int page, int size, String keyword, Long clazzId) {
Page<Alumni> p = new Page<>(page, size);
LambdaQueryWrapper<Alumni> wrapper = new LambdaQueryWrapper<>();
wrapper.like(StringUtils.hasText(keyword), Alumni::getName, keyword)
.eq(clazzId != null, Alumni::getClazzId, clazzId)
.orderByDesc(Alumni::getId);
IPage<Alumni> result = alumniMapper.selectPage(p, wrapper);
// 转换 VO 并填充班级名称
List<AlumniVO> records = result.getRecords().stream().map(Converter::toVO).toList();
return new PageResult<>(records, result.getTotal());
}
这个接口写完必须自己先测分页：第一页和第二页的数据是否重复，keyword 为空时是否查全表。很多同学一上来就复制代码，结果前端下拉加载时翻到第二页，发现数据没变，十有八九是 page 参数从 0 开始还是从 1 开始没对齐。我在接口设计时强制 page 从 1 开始，小程序端做上拉刷新时 page = 1，加载更多时 page + 1，这样最简单。
5.3 文件上传与管理接口
校园风景和要闻封面都会用到图片上传，所以我把文件上传设计成一个通用接口：POST /api/upload。接口接收 multipart 文件，校验文件大小（不超过 5MB），校验后缀名（jpg、png、gif），然后生成唯一文件名并保存到指定磁盘目录。返回数据库保存时需要用的相对路径。
我在这儿踩了一个坑：本地开发时用绝对路径保存，部署到 Linux 服务器后忘了改配置，导致图片上传 500。后来我把保存路径放到配置文件的 app.upload-dir 属性里，上传接口读取配置来拼接路径。这样本机和服务器各写一份配置，互不干扰。图片访问路径则通过一个伪静态映射，把 /upload/** 映射到本地目录，不经过 Controller 层，Nginx 直接处理，效率更高。
6. 小程序端的页面组织与交互细节
小程序端不是简单地把后端接口的数据罗列出来，而是要把“校友会”这个场景的用户体验做到位。我当时把小程序分成五个 tab 页：首页、校友、班级、活动、我的。首页展示要闻和校园风景轮播，校友页支持按班级筛选和搜索，班级页列出班级列表并可查看班级成员，活动页展示报名状态，我的页面展示个人信息和我的报名记录。
6.1 首页数据聚合接口
首页如果要同时展示要闻列表、风景轮播、最新活动三个数据块，让小程序页面发三次请求不太优雅。我在后端设计了一个聚合接口 /api/mini/home，一次请求返回全部首页数据。响应结构类似：
json复制{
"banners": [
{ "id": 1, "image": "/upload/1.jpg", "title": "春日校园" }
],
"news": [
{ "id": 1, "title": "学院举办校友企业合作论坛" }
],
"activities": [
{ "id": 1, "title": "2025年返校日", "status": 1 }
]
}
聚合接口的好处不仅是减少请求数，更重要的是小程序端可以统一处理 loading 状态，不用多次请求相互等待。后端开发时我用一个聚合 Service，分别调用 newsService、sceneryService 和 activityService，最后组装成一个 VO。注意这里要控制好超时时间，如果某个子服务比较慢，尽量做并行调用，或者干脆先不阻塞整体页面，在版面上做局部加载。
6.2 校友列表页面的筛选与触底加载
校友列表页我使用了 WXML 里的 scroll-view 实现下拉刷新和触底加载。页面数据模型包括 list、page、total、loading。每次触底时判断 list.length >= total，否则继续请求下一页。筛选条件我用一个弹出层，点击班级后重新从第一页加载。
一个值得注意的交互细节是，搜索输入框应该做防抖。我用了一个 300ms 的定时器，每次输入内容后先清空上一次定时器，再触发请求。不然用户每敲一个字就请求一次接口，后端无所谓，但小程序体验会卡顿，而且容易出现旧请求覆盖新请求的数据错乱问题。我见过不少项目在搜索时出现“上次关键字的结果串到本次搜索里”，就是因为没有处理竞态条件。在 setData 之前先判断当前关键字的请求是不是最后一次，是才更新页面，这是一个简单有效的方案。
6.3 活动报名与状态回显
活动详情页会显示活动内容、已报名人数、剩余名额和报名按钮。如果当前用户已经报名过，按钮变成“已报名”且置灰。这里需要两个接口：一个查活动详情，一个查当前用户是否已报名。我用一个接口搞定，返回详情的同时返回 isSignUp 字段。后端根据小程序传来的 openid 查询报名表，存在记录就返回 true。
由于用户身份是通过微信登录鉴定的，小程序端在 onShow 时先检查本地是否有 token，没有则跳转到登录页面。这里要注意 openid 不能在前端传入，必须是后端用 wx.login 返回的 code 调用微信接口换取。网上很多教程为了省事直接用 wx.getUserProfile 的 nickname 当用户标识，这是不严谨的。毕设阶段用后端换 openid 也不复杂，微信接口文档写得明白，只需在服务端配置小程序 appid 和 secret，然后调用 jscode2session 接口即可拿到 openid。
7. 部署上线与演示视频录制的实操笔记
系统开发完成后，最让人头疼的是部署。很多毕设源码能跑起来，但部署时遇到 JDK 版本、MySQL 版本、端口占用、防火墙等问题就会卡住。我把自己部署时的完整链路重复一遍，每一步都是我实际操作过的。
7.1 后端打包与部署命令
后端项目用 Maven 打包成 jar 包，命令是 mvn clean package -DskipTests。打包前要确认 application-prod.yml 里的数据库连接地址、账号密码、上传路径都改成了线上环境的值。
打包完成后，把 jar 包上传到服务器 /opt/alumni-system/app.jar，然后执行：
bash复制nohup java -jar /opt/alumni-system/app.jar --spring.profiles.active=prod > /opt/alumni-system/logs/app.log 2>&1 &
建议用 ps -ef | grep app.jar 检查进程是否启动，再用 tail -f /opt/alumni-system/logs/app.log 查看启动日志。如果启动失败，优先看有没有端口冲突和数据库连接失败，这是两个最高频的错误。
为了让项目启动后不因为服务器重启而失效，我加了 Systemd 服务或者直接使用 nohup 也行。毕设演示时不强制做进程守护，但如果你想让系统显得更专业，可以写一个 alumni.service 文件，配置 ExecStart 和 Restart=always，这样哪怕程序崩溃了也会自动拉起。
7.2 小程序端的服务器域名配置
上线时，小程序必须把 request 请求的域名指向已经备案并通过校验的 HTTPS 域名。如果你用的是云服务器，可以申请免费的 SSL 证书，在 Nginx 中配置：
nginx复制server {
listen 443 ssl;
server_name yourdomain.com;
ssl_certificate /etc/nginx/ssl/yourdomain.pem;
ssl_certificate_key /etc/nginx/ssl/yourdomain.key;
location /api/ {
proxy_pass http://127.0.0.1:8080/api/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
location /upload/ {
alias /opt/alumni-system/upload/;
}
}
Nginx 配置好之后，进入微信公众平台，把 yourdomain.com 加进 request 合法域名和 uploadFile 合法域名。这一步千万不要忘记在小程序后台操作，否则真机上请求会被拦截，控制台报“url not in domain list”。
我部署时还遇到一个问题：服务器上已经装了 MySQL 8.0，但项目连接串用的是 MySQL 5.x 的驱动类 com.mysql.jdbc.Driver，启动直接报错。解决方法是把连接串改为 jdbc:mysql://localhost:3306/alumni_system?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai，驱动换成 com.mysql.cj.jdbc.Driver。如果你用 MyBatis-Plus，它的默认依赖通常会带新版驱动，但一些旧项目模板可能不会自动更新，需要手动检查。
7.3 演示视频录制的思路
标题里提到的“演示视频”，其实没有你想的那么复杂。录制前准备一个录制脚本，先展示管理员端功能，再切到小程序端，保证每个核心模块都被点到。我录制的流程是这样：管理员登录后台，先新增一个班级，再添加一位校友，上传一张校园风景图片，发布一条要闻，创建一个新活动类型和活动；然后打开小程序端，查看首页轮播和要闻，进入校友页搜索刚才录入的校友，进入活动页给新活动报名，最后在“我的”页面看到报名记录。
视频不要一镜到底，可以分段剪辑，每段控制在四十秒以内。重点展示接口返回数据和页面效果，不用把代码读出来。如果演示过程中出现网络慢，可以把后端和前端同时录进屏幕里，用手机录真机预览画面，电脑录后端运行日志，这样看到页面响应和日志同时出现，显得真实可靠。
8. 从踩坑到复盘：给后来者的几条实用建议
项目做完之后，回想整个开发过程，有几个踩到的坑至今记忆犹新。写在这里，给你们提前避雷。
第一个坑是跨域。小程序端请求后端接口时，如果开发环境使用 http://localhost:8080 作为 BaseURL，而小程序真机预览时访问的是云服务器地址，后端一定要配置跨域过滤器。我在后端加了一个 CorsFilter，允许所有来源，同时允许确实需要保留的请求头。不要为了省事不加跨域配置，否则浏览器调试工具会报 CORS 错误。
第二个坑是日期格式化。前后端传输日期时默认是 yyyy-MM-ddTHH:mm:ss 的 ISO 格式，小程序端直接显示会很难看。我的做法是在后端实体类上使用 @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")，同时在全局配置了 Jackson 的日期格式，保证所有接口返回统一格式。这样前端不用再做字符串切割，省了大把时间。
第三个坑是 MyBatis-Plus 的逻辑删除和唯一索引冲突。我给校友表加了一个 phone 唯一索引，当一个校友真的被逻辑删除后，再添加一个同手机号的新校友，会直接报“Duplicate entry”。当时我查了很久才发现，逻辑删除不会触发物理删除，唯一索引仍然存在。解决办法是，让手机号唯一索引关联 deleted 字段，把索引改为 UNIQUE KEY (phone, deleted)，这样逻辑删除后的记录可以和新记录共存。
第四个坑是富文本内容的图片处理。要闻正文里的图片，如果直接复制粘贴，图片地址可能不是本地上传路径，而是一串 base64，存进数据库后会导致记录很长而且小程序渲染变慢。我后来在富文本编辑器的图片上传接口上做了图片转存处理，让编辑器插入的图片一律走上传接口，返回可访问的 URL。这样数据库里存的是普通字符串而不是大段 base64 数据。
最后，我想说一句整体感受。做这类管理系统，别把精力全部放在“功能能跑”上，数据库设计、接口规范、部署流程这三块才是区分普通代码和高质量项目的分水岭。我自己在开发过程中花了很多时间调小程序真机适配，后来发现其实先把接口和数据结构定稳，前端页面反而是最快速的部分。如果你手头正好在做一个校友会系统，建议先照着上面的思路把表建好、接口调通，再去处理前端的按钮漂亮不漂亮，这样整个项目才会越做越顺。