芙蓉塘外有轻雷大学毕业设计选什么题，一直是很多同学头疼的事。如果现在有人问我，我通常会推荐管理系统类的题目，尤其是基于 SpringBoot 的校园业务场景。大学生社团活动平台就是这类题目里很经典的一个：业务逻辑不复杂，但该有的技术点基本都覆盖了——用户认证、权限控制、数据关联、文件上传、消息通知、前后端联调，一套下来，SpringBoot 的核心用法差不多都能过一遍，应付毕业答辩绰绰有余，用来写进简历也拿得出手。这篇博文我就以这个实战项目为背景，把从需求拆解、数据库设计、后端接口实现，到本地调试运行、常见坑排查的完整过程都过一遍。不管你现在是刚启动毕设毫无头绪，还是代码写得差不多了但是卡在某个环境问题上，这篇都能给你一些可以直接抄作业的参考。
先交代一下这个项目的通用画像：技术栈一般是 SpringBoot + MyBatis/MyBatis-Plus + MySQL，前端可能是 Vue + Element UI，也可能用简单的 Thymeleaf 模板，取决于你手里拿到的版本。角色通常分三种：学生、社团管理员、系统管理员。核心业务围绕社团和活动两条线展开——学生可以浏览社团、申请加入、查看活动、报名活动；社团管理员负责管理成员、发布活动、审核报名；系统管理员管社团审核、用户管理、数据统计。就这么点事儿，但是做扎实了，够你写出一份像样的毕业设计论文。
1. 项目整体设计与技术选型思路
1.1 为什么是 SpringBoot 而不是 SSH 或者 SSM
先说选题层面的问题。很多学校其实不限制技术栈，有些老教师甚至更熟悉 SSH（Struts2 + Spring + Hibernate），但你现在打开招聘网站看一眼，SSH 的岗位几乎绝迹了，SSM（Spring + SpringMVC + MyBatis）虽然还在一些老系统里跑，但新项目基本都迁移到 SpringBoot 上了。
SpringBoot 带来的最大改变是“约定大于配置”。以前 SSM 阶段搞一个项目，光 spring-mvc.xml、spring-mybatis.xml、web.xml 这几个配置文件就够折腾一整天的，各种扫描路径、视图解析器、拦截器配置，一个 namespace 写错就直接启动失败。SpringBoot 把这些全部自动化了，内嵌 Tomcat，java -jar 就能跑，配置集中在 application.yml 里，结构清晰，排查问题也快。
另外还有一个很现实的原因：毕设答辩时，老师大概率会问“你为什么选这个技术栈”。SpringBoot 可以理直气壮地说“它是当前 Java 服务端开发的主流框架，学习成本低、生态完善、社区活跃”，这个答案既安全又专业，不像选了 SSH 还要费劲解释为什么选一个快被淘汰的组合。
1.2 技术栈搭配的底层逻辑
这个项目的标准技术栈组合很有意思，每个环节都有值得说道的地方：
- JDK 1.8 + SpringBoot 2.x：这是国内绝大多数高校和中小公司还在用的组合，稳定、教程多、踩坑资料最全。SpringBoot 3.x 要求 JDK 17，虽然新，但很多旧教程用的是 javax 命名空间，你按新版本写很容易发现 import 全部报错，对新手来说这纯粹是给自己增加难度。
- MyBatis-Plus 而不是原生 MyBatis：必选，没有悬念。单表 CRUD 直接继承 BaseMapper，连 SQL 都不用写，条件构造器 QueryWrapper 做动态查询非常方便。原生 MyBatis 写一大堆 XML mapper 的方法在这里纯属浪费时间，而且你写多了反而容易被老师追问细节。
- MySQL 5.7 或 8.0：看本机环境。MySQL 8.0 要注意驱动名改成 com.mysql.cj.jdbc.Driver，时区参数也不能省。
- JWT + Spring Security 或者拦截器：权限这块是答辩老师最喜欢问的地方。完整的方案是用 Spring Security + JWT，但说实话配置门槛有点高。如果你只是想稳妥搞定毕设，自定义拦截器 + JWT 工具类也完全够用，答辩解释起来反而更简单。这个选择取决于你手里项目的实际情况，后面我会详细说。
- Vue + Element UI 做前端：前后端分离是现在的主流做法，Element UI 的表格、表单、弹窗组件非常成熟，你不需要会写好看的 CSS，靠着组件库就能拼出一个像模像样的管理后台。如果完全不会 Vue，也可以选 Thymeleaf 服务端渲染，但那种方案的公司招聘认可度明显低一档。
1.3 角色权限设计是第一个核心考点
社团活动平台的权限模型属于典型的 RBAC（基于角色的访问控制），但和网上烂大街的后台管理系统不一样，它有一个很容易被忽视的坑：一个人可以同时拥有多个角色。
一个学生办了社团，他就是“社团管理员”加“普通学生”。如果他加入另一个社团，他只是那个社团的普通成员。如果他又被学校社联聘为管理员，那还要能管理所有社团的信息。这种“用户-角色-社团”三层关联如果在设计表结构的时候没想清楚，后面写业务逻辑的时候会把自己绕死。
我建议的权限模型是：
- sys_user 表存用户基本信息（账号、密码、姓名、学号、联系方式）
- sys_role 表存角色（学生、社团管理员、系统管理员）
- sys_user_role 表存用户和角色的关联
- club 表属于哪个用户创建的，用 create_by 字段标记
- club_member 表存社团成员关系，包含成员角色（社长、副社长、普通成员）
这样设计的核心思想是：一个用户通过 user_role 知道自己有哪些角色权限，再通过 club_member 知道自己属于哪个社团、在社团里是什么身份。权限判断的时候，先看有没有某个角色，再看是不是某个社团的负责人。这个逻辑理清楚了，后面的控制层拦截器、业务层判断都会顺很多。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心功能模块拆解与实现逻辑
2.1 用户认证与注册登录
用户模块是整个平台的门面。学生和社团管理员都需要先注册才能使用平台，注册时通常要填学号、姓名、密码、联系方式、院系专业。这里有两个细节值得注意：
第一，密码不能明文存。Spring Security 自带的 BCryptPasswordEncoder 是首选，如果没引入 Spring Security，也可以用 hutool 工具类的 BCrypt 实现或者 MD5 加盐。毕设论文里面“密码加密存储”这个点写上去，是实打实的亮点。
第二，登录成功之后签发 JWT。JWT 由三部分组成：Header、Payload、Signature。服务端用密钥对 Header 和 Payload 签名，客户端保存 token，每次请求放到 Authorization 头里。服务端拦截器验签通过后，从 token 里解析出用户 ID 和角色列表，放到底座上下文里，后续业务直接拿。
实际写代码的时候，JWT 工具类也就百来行，核心是这几个方法：
java复制public class JwtUtil {
private static final String SECRET = "your-secret-key";
private static final long EXPIRE_TIME = 24 * 60 * 60 * 1000;
public static String generateToken(Long userId, String username, List<String> roles) {
Date now = new Date();
Date expireDate = new Date(now.getTime() + EXPIRE_TIME);
return Jwts.builder()
.setSubject(username)
.claim("userId", userId)
.claim("roles", roles)
.setIssuedAt(now)
.setExpiration(expireDate)
.signWith(SignatureAlgorithm.HS256, SECRET)
.compact();
}
public static Claims parseToken(String token) {
return Jwts.parser().setSigningKey(SECRET).parseClaimsJws(token).getBody();
}
}
注意一个坑：jwt 的依赖有 jjwt 0.9.x 和 0.11.x 两个大版本，API 差别很大。0.11.x 用 Keys.hmacShaKeyFor() 生成密钥，而 0.9.x 直接字符串签名即可。你手里版本不同，代码可能对不上，如果编译报错，先查一下依赖版本再改代码。
2.2 社团管理模块：审核与成员关系
社团管理是整个平台业务逻辑最重的模块，它包含了几条很容易写乱的状态流转。
第一条是社团创建与审核。学生提交创建社团申请，填写社团名称、类别（学术科技类、文化艺术类、体育竞技类等）、简介、logo，系统管理员在后台审核，通过后社团状态从未审核变成已通过。这里设计一个 status 字段就够了，0 未审核、1 审核通过、2 已驳回。驳回的时候还可以加一个审核意见字段。
第二条是加入社团。学生对某个已通过的社团点“申请加入”，社团管理员在管理端看到申请列表，同意后就往 club_member 表插入一条记录。这里同样有状态字段：0 待审核、1 已通过、2 已拒绝。这块最容易被忽略的问题是：同一个学生对同一个社团不能重复提交申请。所以你在插入之前必须先查一下有没有 pending 或 already approved 的记录。这个逻辑在 Service 层一定要处理，不然就会出现一个用户加同一个社团十几次的数据脏数据。条件构造器一行就能搞定：
java复制long count = clubMemberMapper.selectCount(
new QueryWrapper<ClubMember>()
.eq("user_id", userId)
.eq("club_id", clubId)
);
if (count > 0) {
throw new BusinessException("您已经申请过该社团，请勿重复提交");
}
2.3 活动管理模块：发布、报名与签到
活动是平台里最亮眼的业务。社团管理员创建活动时，要填活动名称、封面图、活动地点、开始时间、结束时间、报名截止时间、最大报名人数、活动详情。这里面藏着两个容易被老师追问的点：
报名截止时间逻辑判断。如果一个活动已经过了报名截止时间，就不能再报名；如果已经报满，也不能再报。这两条判断要在接口里加，不能只在前端禁掉按钮。前端禁掉只是用户体验，后端不拦截才是真漏洞。
活动状态自动流转。一个活动有四种状态：未开始、进行中、已结束。你当然可以在每次查询的时候用当前时间动态算出来，不用存字段，这样可以省去定时任务。展示列表的时候，直接判断当前时间和活动开始、结束时间，就能算出一个状态文字。这个方案简单且不会出现数据不一致。
报名模块还有一个扩展点是签到：活动开始后，社团管理员能看到已报名名单，点击签到按钮，往签到表里写记录。这个功能虽然不起眼，但是放在论文里能体现你考虑了完整的业务闭环，而不只是做了几个 CRUD 接口。
2.4 公告与通知：让系统有“活”的感觉
很多毕设做到最后就是几张大表互相调，完全没有任何消息触达能力。如果能在活动审核通过、社团审核通过、报名成功这些节点给用户生成一条站内信或者公告，系统的完整度会瞬间上一个台阶。
实现上不需要用到消息队列，就建一张 sys_notification 表，字段包括接收人、标题、内容、是否已读、创建时间。当活动管理员发布活动后，给所有社团成员生成一条通知；当系统管理员审核通过社团后，给社团创建人发一条通知。前端在导航栏右上角显示一个未读红点，点击进去是通知列表，已读的置灰。这个小功能前后端加起来不到一天工作量，但答辩演示的时候效果极好。
2.5 数据统计模块：答辩加分项
系统管理员后台可以做一个简单的数据看板：社团总数、活动总数、注册用户数、本周新增活动数。如果用 MySQL 的聚合函数，基本就是几条 SQL 的事：
java复制// 统计各类型社团数量
select club_type, count(*) as cnt from club group by club_type
然后把结果返回给前端，用 ECharts 画一个饼图。图形化展示这个东西，在毕设答辩里的冲击力比一百行文字描述都要大。如果你的项目是前后端分离的，前端引入 ECharts 非常容易，甚至不用 npm 安装，直接 cdn 引一个 <script> 标签就能用。这个模块工作量不大，性价比极高。
3. 数据库设计关键点与表结构精讲
3.1 核心表结构一览
直接贴出这个项目最核心的几张表结构，你在建库建表的时候可以直接参考：
sql复制-- 用户表
CREATE TABLE sys_user (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
username VARCHAR(50) NOT NULL UNIQUE COMMENT '登录账号',
password VARCHAR(100) NOT NULL COMMENT '密码(BCrypt加密)',
real_name VARCHAR(50) COMMENT '真实姓名',
student_no VARCHAR(20) COMMENT '学号',
phone VARCHAR(20),
email VARCHAR(100),
avatar VARCHAR(255),
status TINYINT DEFAULT 1 COMMENT '1启用 0禁用',
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
);
-- 角色表
CREATE TABLE sys_role (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
role_code VARCHAR(50) UNIQUE NOT NULL,
role_name VARCHAR(50)
);
INSERT INTO sys_role VALUES (1, 'STUDENT', '学生');
INSERT INTO sys_role VALUES (2, 'CLUB_ADMIN', '社团管理员');
INSERT INTO sys_role VALUES (3, 'ADMIN', '系统管理员');
-- 用户角色关联表
CREATE TABLE sys_user_role (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
user_id BIGINT NOT NULL,
role_id BIGINT NOT NULL
);
-- 社团表
CREATE TABLE club (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
club_name VARCHAR(100) NOT NULL,
club_type VARCHAR(50) COMMENT '社团类别',
logo VARCHAR(255),
description TEXT,
creator_id BIGINT COMMENT '创建人用户ID',
status TINYINT DEFAULT 0 COMMENT '0待审核 1通过 2驳回',
audit_remark VARCHAR(255) COMMENT '审核意见',
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
);
-- 社团成员表
CREATE TABLE club_member (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
club_id BIGINT NOT NULL,
user_id BIGINT NOT NULL,
role TINYINT DEFAULT 1 COMMENT '1普通成员 2社长 3副社长',
status TINYINT DEFAULT 0 COMMENT '0待审核 1已通过 2已拒绝',
join_time DATETIME DEFAULT CURRENT_TIMESTAMP
);
-- 活动表
CREATE TABLE activity (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
club_id BIGINT NOT NULL,
title VARCHAR(100) NOT NULL,
cover VARCHAR(255),
location VARCHAR(200),
start_time DATETIME NOT NULL,
end_time DATETIME NOT NULL,
signup_deadline DATETIME NOT NULL,
max_people INT DEFAULT 100,
detail TEXT,
status TINYINT DEFAULT 0 COMMENT '0待审核 1已通过 2已驳回',
create_by BIGINT COMMENT '发布人用户ID',
create_time DATETIME DEFAULT CURRENT_TIMESTAMP
);
-- 活动报名表
CREATE TABLE activity_signup (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
activity_id BIGINT NOT NULL,
user_id BIGINT NOT NULL,
signup_time DATETIME DEFAULT CURRENT_TIMESTAMP,
status TINYINT DEFAULT 1 COMMENT '1已报名 0已取消'
);
3.2 表设计容易忽略的索引与外键
很多同学建表的时候只关注字段，完全忽略索引。虽然毕设数据量小，加不加索引性能上没区别，但你在论文的数据库设计章节写一句“对经常查询的 user_id、club_id、status 字段建立了普通索引”，答辩老师会觉得你考虑问题到位。
外键这块我的建议是：逻辑外键，不要物理外键。也就是说，在表设计文档里有“外键”这个概念，但建表语句不加 FOREIGN KEY 约束。原因很简单：现在互联网公司的生产环境基本都不用物理外键，因为会影响插入删除性能、不利于分库分表。而且物理外键会导致你删数据的时候各种报错——你删一个社团，它下面有活动记录，外键约束直接拦截，你还得先处理子表数据。这在毕设开发调试阶段会浪费你大量时间。
3.3 逻辑删除的魅力与坑
既然用 MyBatis-Plus，强烈建议所有业务表都加上 deleted 字段，然后配置逻辑删除：
yaml复制mybatis-plus:
global-config:
db-config:
logic-delete-field: deleted
logic-delete-value: 1
logic-not-delete-value: 0
这个配置一旦打开，你调用 deleteById 的时候，它实际执行的是 UPDATE ... SET deleted=1 WHERE id=?，查询的时候自动加 deleted=0 条件。好处是数据不会物理消失，误删能恢复，对毕设来说也少了编写 DELETE 语句的麻烦。
但注意一个坑：如果有联合唯一索引（比如某个字段对同一个用户只能有一条记录），逻辑删除后这个唯一索引可能会冲突。遇到这种情况，可以改用 deleted 字段存时间戳（0 表示未删除，非 0 表示删除时间），这样即使多次删除也不会冲突。这是个进阶技巧，能懂更好，不懂也没关系，毕设场景基本用不到联合唯一索引。
4. 实操：环境准备、项目导入与启动部署
4.1 本地开发环境搭建
拿到源码之后，第一件事是在本地把环境跑起来。不要着急看代码，先保证项目能启动，再逐步阅读逻辑。推荐的环境组合如下：
- JDK 1.8：必须的，SpringBoot 2.x 的最佳搭档。安装后命令行执行 java -version 确认。
- Maven 3.6+：用于依赖下载和项目构建。国内用户记得配置阿里云镜像，否则下载依赖能等到怀疑人生。
- MySQL 5.7 或 8.0：建议直接装一个集成环境，省心。
- IDEA 2020 以上：社区版或者专业版都行，社区版也能跑 SpringBoot，只是没有 Spring 插件提示，影响不大。
- Navicat 或者 DataGrip：数据库管理工具，导入 SQL 脚本用。
- Postman 或者 Apifox：接口测试工具，调试登录注册和各类业务接口。
我就见过不止一个同学卡在 Maven 镜像这一步。Maven 默认从中央仓库下载依赖，国外服务器，速度慢且不稳定。改一下 settings.xml，加阿里云镜像：
xml复制<mirror>
<id>aliyunmaven</id>
<mirrorOf>*</mirrorOf>
<name>阿里云公共仓库</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
改完之后，重新 Reimport 一下 Maven 工程，你会感觉世界都明亮了。
4.2 数据库初始化与连接配置
打开 Navicat，新建数据库，字符集选 utf8mb4，排序规则选 utf8mb4_general_ci，然后右键运行 SQL 文件，把项目里带的 club-platform.sql 导进去。导入成功后，可以看到 sys_user、club、activity 这些表，以及几条初始化数据。
然后打开后端项目的 application.yml，改数据库连接配置：
yaml复制server:
port: 8080
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/club_platform?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
username: root
password: 123456
mybatis-plus:
mapper-locations: classpath*:mapper/**/*.xml
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
这里三个常见问题提一下：第一，MySQL 8.0 的驱动类是 com.mysql.cj.jdbc.Driver，如果你用 MySQL 5.7 的 jar 驱动写成 com.mysql.jdbc.Driver 也能跑，但不推荐。第二，serverTimezone 必须设置，否则启动会报时区错误。第三，password 改成你自己的数据库密码，这是最容易报错的点之一。
4.3 启动后端服务
在 IDEA 里打开项目，等待 Maven 把依赖全部下载完（第一次要挺久的，下载完第二次就快了），找到主类，通常叫 ClubPlatformApplication.java，类上有 @SpringBootApplication 注解。右键 -> Run。
启动过程中观察控制台日志。当看到类似这样的输出时，说明启动成功：
text复制Tomcat started on port(s): 8080 (http) with context path ''
Started ClubPlatformApplication in 5.123 seconds
启动成功之后先用浏览器访问一下 http://localhost:8080，如果返回了错误页面或者 JSON 数据（比如 404），说明服务是通的，只是没有匹配的路径。再用 Postman 请求一下 /api/auth/login，传入 admin/123456，能返回 token 就说明整个链路通了。
4.4 前端项目启动与代理配置
如果是前后端分离的项目，前端代码通常在单独的文件夹里，比如 frontend 或者 vue-ui。需要先安装 Node.js 环境，然后在命令行进入前端目录，执行：
bash复制npm install
这一步会安装 Vue 相关的依赖包。下载量很大，如果卡住，可以换成淘宝镜像源：
bash复制npm config set registry https://registry.npmmirror.com
npm install 完成后，启动开发服务器：
bash复制npm run dev
启动以后，终端会打印一个本地访问地址，通常是 http://localhost:8081 或 http://localhost:3000。打开浏览器访问。
前端开发服务器默认端口和后端 8080 不一样，所以要走代理。在 vue.config.js 或者 vite.config.js 里配置：
javascript复制module.exports = {
devServer: {
port: 8081,
proxy: {
'/api': {
target: 'http://localhost:8080',
changeOrigin: true
}
}
}
};
这样前端请求 /api/xxx 时，会自动转发到后端 8080 端口，不会出现跨域报错。这个代理配置是前后端分离项目里最常踩的坑之一，我后面会专门讲。
4.5 打包部署：从 IDEA 到 jar 包再到 Docker
开发调试完成以后，肯定要打一个可执行的 jar 包。在 IDEA 终端或者项目根目录执行：
bash复制mvn clean package -DskipTests
执行完以后，在 target 目录下会生成一个 jar 文件。然后在服务器或者本地执行：
bash复制java -jar club-platform-0.0.1-SNAPSHOT.jar
前端如果想要让同学或者老师访问，也可以构建静态文件，然后用 Nginx 部署，或者直接用 SpringBoot 的静态资源目录（把前端 build 产物扔到 resources/static 下）也可以。
说到 Docker 部署，热搜词里有一条“springboot jdk1.8打包到docker desktop”值得专门说一下。如果你想把项目容器化，Dockerfile 很简单：
dockerfile复制FROM openjdk:8-jdk-alpine
VOLUME /tmp
ADD target/club-platform-0.0.1-SNAPSHOT.jar app.jar
ENV JAVA_OPTS=""
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]
然后构建镜像：
bash复制docker build -t club-platform:1.0 .
docker run -d -p 8080:8080 --name club-platform club-platform:1.0
这里要提醒一句：如果用了 MySQL，容器里的应用是连不上你本机 localhost 的 MySQL 的。因为容器内的 localhost 是容器自己。你需要让 MySQL 也跑在容器里，然后通过 docker-compose 把两个服务编排起来，或者把数据库连接地址改成你宿主机的局域网 IP。这个题目稍微有点深，如果不需要部署到服务器，可以暂时先不搞 Docker，本地跑起来就够了。
5. 常见问题与排查技巧实录
5.1 账密对但登录一直 401
这个概率极高。先在后端确认数据库里存的密码是不是加密后的字符串，如果是 BCrypt 加密的，用 Postman 传明文密码测试，服务端会调用 BCryptPasswordEncoder.matches() 去比对。如果中间的 compare 逻辑写错了，或者请求参数名和前端的字段名对不上，就会出现 401。
排查技巧：在后端 Controller 打日志，把收到的 username 和 password 打印出来，看是不是 null。如果 password 是 null，多半是前端传参的方式问题——用 query 字符串传的，后端用 @RequestBody 接，或者反过来。前后端字段名不一致是最常见的原因。还有一个非常隐蔽的问题，就是 POST 请求的 Content-Type 不是 application/json，而是 application/x-www-form-urlencoded，导致 JSON 解析失败。
5.2 端口被占用导致启动失败
启动报错：Port 8080 was already in use 或者 APPLICATION FAILED TO START。一般是上一个项目的进程还没结束，或者某个程序占用了端口。Windows 下用这个命令查：
bash复制netstat -ano | findstr 8080
看最后一列 PID，然后打开任务管理器结束对应进程。或者更省事一点，直接换端口，在 application.yml 里把 server.port 改成 8081、8082 都行。
5.3 数据库连接失败：Access denied / Unknown database
启动时如果报 Access denied for user 'root'@'localhost'，说明账号密码不对，检查 application.yml 的 username 和 password，注意别把密码写成 root 占位符没改。如果是 Unknown database 'club_platform'，说明数据库建库的时候名字不对，或者 SQL 没导入。
还有一个很容易出错的情况：MySQL 8.0 默认使用 caching_sha2_password 认证插件，某些老版本的 JDBC 驱动不支持，会报 Unable to load authentication plugin 'caching_sha2_password'。解决办法是升级 MySQL Connector/J 到 8.0.x，或者在 MySQL 里把用户的认证方式改回 mysql_native_password。毕设直接用新版驱动就行。
5.4 Lombok 报错：java: You aren't using a compiler supported by lombok
这个报错在热搜词里也出现了，非常经典。Lombok 通过注解处理器在编译期自动生成 getter/setter/构造器代码，但如果 IDEA 里没启用注解处理器，或者 Lombok 版本和 JDK 版本不兼容，就会报这个错。
解决办法分三步走：第一，pom.xml 里引入 Lombok 依赖，注意版本要和 JDK 匹配；第二，IDEA 安装 Lombok 插件（新版 IDEA 自带，老版本需要手动装）；第三，打开 IDEA 设置，在 Build -> Compiler -> Annotation Processors 里勾选 Enable annotation processing。做完这三步，Rebuild Project 基本就能解决。
5.5 前端请求跨域：CORS 报错
前后端分离开发时，前端 http://localhost:8081 请求后端 http://localhost:8080，浏览器会拦截跨域请求。虽然开发时可以通过 proxy 代理解决，但如果你直接用 axios 访问 http://localhost:8080/api 而不是用相对路径 /api，那 proxy 就失效了。
排查思路：看一下前端代码里 axios 的 baseURL 是什么。如果写死了 http://localhost:8080/api，那就不是代理能解决的，需要后端开启跨域支持。一个简单的方案是加一个 CORS 配置类：
java复制@Configuration
public class CorsConfig implements WebMvcConfigurer {
@Override
public void addCorsMappings(CorsRegistry registry) {
registry.addMapping("/**")
.allowedOriginPatterns("*")
.allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS")
.allowedHeaders("*")
.allowCredentials(true)
.maxAge(3600);
}
}
加上这个之后，跨域问题基本就解决了。但注意，如果你同时开启了 Spring Security，CORS 配置必须在 Security 的过滤链里也开放，否则请求照样会被拦。
5.6 MyBatis-Plus 分页查询失效
很多同学在写列表页的时候，发现分页查询返回的 total 一直是 0 或者查出来全是同一页的数据。这是因为 MyBatis-Plus 的分页功能需要手动注入分页插件。
在配置类里加一个 Bean：
java复制@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
return interceptor;
}
没有这个插件，Page 参数会被忽略，SQL 不会拼接 LIMIT 语句。这是 MyBatis-Plus 很典型的一个坑，几乎每届毕设都会有人踩到。
5.7 热门词“springboot banner生成器”能拿来干什么
这个小工具虽然跟业务没关系，但用好了能让你在细节上胜出。SpringBoot 启动的时候会打印一个 ASCII Art 的 banner，默认是 Spring 的 logo。你可以用 banner 生成器（网上搜 springboot banner 在线生成）把你的项目名或者姓名做成一个大号 ASCII 字样，然后放到 src/main/resources/banner.txt 里。
下次启动项目的时候，控制台就会打印你的专属 banner。答辩演示的时候，老师看到那个“CLUB PLATFORM”大 logo，会觉得你是真的用心在做这个项目。这种细节不需要花多少时间，但效果很值。
5.8 单元测试的应用
“springboot 单元测试最佳实战”这类搜索词热度一直很高。毕设项目中，至少给核心业务接口写几个简单的单元测试，比如社团申请去重、活动报名人数限制、登录状态校验。这不仅能在答辩时展示你的工程化意识，还能帮助你在改代码后快速回归。
一个标准的 Service 层测试类大概是这样的：
java复制@SpringBootTest
@Transactional
class ActivityServiceTest {
@Autowired
private ActivityService activityService;
@Test
void testSignupLimit() {
// 前置准备：设置活动最大报名人数为2，插入两条报名记录
// 调用报名接口，断言抛异常
assertThrows(BusinessException.class, () -> activityService.signup(activityId, userId));
}
}
加上 @Transactional 注解后，每个测试方法执行完会自动回滚，不会污染数据库。这个技巧在写 CRUD 测试时特别有用。
6. 一套可以直接用的部署检查清单
调试运行碰到问题先别慌，对照这张清单逐项排查：
| 检查项 | 预期结果 | 常见错误 |
|---|---|---|
| JDK 版本 | 1.8 及以上，java -version 正常输出 | 未安装或环境变量没配好 |
| Maven 环境 | mvn -v 正常输出，依赖已下载 | 镜像未配置，下载超时 |
| MySQL 服务 | 服务已启动，能连接，SQL 已导入 | 服务未启动，密码不对，库名不对 |
| application.yml | 数据库账号密码正确，端口未被占用 | 配置项拼写错误 |
| 后端启动 | 控制台打印 Started 成功 | 端口冲突，驱动类错误 |
| 前端依赖 | npm install 成功 | Node 版本不对，镜像源不通 |
| 前端代理 | 请求 /api 能转发到后端 | baseURL 写死为 localhost:8080 |
| 登录测试 | 返回 token，跳转正常 | 参数名不一致，JWT 密钥不一致 |
| 业务操作 | 创建社团、报名活动成功 | 状态字段枚举值不匹配，查询条件错误 |
7. 写在后面的一些实在话
做了这么多年项目，带了不少实习生和做毕设的同学，我最大的感受是：社团活动平台这一类系统，技术上真的不难，难的是把每一步做扎实。数据库字段设计是否合理、接口返回格式是否统一、异常处理是否到位、代码注释是否清晰，这些不起眼的点恰恰是导师和面试官最关注的。如果你手里已经有了一套源码，建议不要直接交上去就完事，至少把核心的几个业务逻辑从头到尾读一遍，改掉几个写法不够好的地方，加一个自己的小功能。把项目变成“你的”，答辩的时候才会言之有物，也才能真正学到东西。
最后再分享一个小技巧：遇到问题的时候，先看控制台日志，再把错误信息完整复制到搜索引擎里搜。不要只看第一行，更要看下面带着“Caused by”的那几行，那才是问题的真正根源。调试运行的乐趣，其实就在一点点把线头理清的过程中。祝你的毕设顺利通关。