Spring Boot校园志愿者服务平台实战：从设计到部署全解析

1. 项目定位与整体设计思路写这类Spring Boot校园项目已经不算新鲜事了但每次在答疑群里看到有人拿“校园志愿者服务平台”这种题目来问我都会多聊几句。原因很简单它的业务边界很清晰既不像电商系统那样有复杂订单和支付也不像内容管理系统那样要死磕权限粒度但它非常完整地覆盖了Java学习路线里的高频考点——登录鉴权、CRUD、文件上传、多表关联、数据统计、权限控制以及最考验经验的“部署和调试”。这也是为什么各种课程设计和毕业设计都爱选它。这类项目的关键不是“把功能做完”而是“把技术栈选好、表结构设计明白、部署过程能复现”。很多同学在开发阶段写得挺顺一到答辩演示就翻车大概率是栽在部署环境和数据一致性上。所以这篇文章我不会只给你一个功能清单而是从项目拆解、数据库设计、环境搭建、核心模块实现一直到调试部署方案全部过一遍。想把它复现出来作为课设、毕设或者练手项目照着这条路走基本不会踩大坑。1.1 校园志愿者服务平台到底解决什么问题校园里的志愿活动组织长期以来都是靠QQ群、Excel表格、甚至纸质签到表来维护的。活动发布靠人工转发报名靠接龙时长统计靠手动录入最后汇总时长的时候更是灾难现场。这类平台的价值就是把“活动发布—在线报名—签到签退—时长录入—个人中心查看”这条链路拉到线上管理端能审核活动、管理用户、导出数据学生端能浏览活动、提交报名、查看自己的志愿时长、维护个人资料。放在功能设计上它至少包含两类角色普通学生用户和管理员。再细分一点活动负责任人也算一个角色但大多数课设版本会把它并入管理员端或者用字段区分。用户端核心页面是“活动列表”“活动详情”“我的报名”“个人中心”管理员端核心页面是“活动管理”“用户管理”“时长审核”“数据统计”。这些页面靠的是几十个接口在后端支撑数据全部落在MySQL里。我在设计这类系统时习惯先用一句话定义核心业务边界“学生能看活动、能报名、能签到管理员能发活动、能审核、能看统计数据。”这句话听起来简单但它决定了整个表结构、权限设计和接口划分。凡是超出这句话的功能先别急着做课设阶段功能不是越多越好功能多了意味着Bug多、答辩问题多。1.2 技术选型为什么是Spring Boot而不是其他框架技术栈的选型说到底是“确定性优先”。对这个项目来说Spring Boot几乎是必胜选项。原因很直白Spring Boot 的自动配置机制把原本Spring里让人头疼的XML配置、bean装配、数据源初始化全数封装好了一个SpringBootApplication就能把项目跑起来。这不仅对学生友好对于最终部署时的“可复制性”也非常关键。版本上我强烈建议用Spring Boot 2.7.x配合JDK 1.8。很多人图新鲜用JDK17甚至JDK21但课程设计的评分老师大概率不是天天跟新版本打交道的人JDK8和Spring Boot 2.7的组合在兼容性和生态支持上最稳。模板引擎、MyBatis、Redis客户端这些常用的库都能平滑适配遇到问题时网上的现成解决方案也最多。持久层用MyBatis-Plus这是提升开发效率的大杀器。单表CRUD基本不用手写SQLselectById、page、wrapper这些内置方法帮你省掉一半工作量。业务涉及多表查询时再单独写XML里的自定义SQL结构也不会混乱。不过要注意一点MyBatis-Plus的分页插件需要额外配置一个MybatisPlusInterceptor把它注册成PaginationInnerInterceptor不配的话Page对象不会真正执行分页只会查出全表数据。这个坑我从答疑群里见过了不下几十次。数据库用MySQL 5.7或MySQL 8.0。两者在绝大多数情况下没区别但注意MySQL 8.0的密码加密规则是caching_sha2_password如果你的应用服务器上用的是5.7对应版本的驱动连接数据库时会出现认证失败。解决方案是换用较新的mysql-connector-java版本或者在创建用户时指定mysql_native_password二选一即可。前端方案也要早定。预算有限的课设项目最省心的组合是Thymeleaf服务端渲染加Bootstrap、jQuery不用单独启动一个前端开发服务器Spring Boot用Controller直接返回页面视图整个项目只有一个进程部署非常方便。如果追求界面交互效果更好一点可以用Vue 3搭配Element Plus通过接口与后端交互前后端分离。选这条路会让项目在演示时更亮眼但也会引入跨域、Nginx静态资源托管、前端打包这些额外问题调试复杂度会上升。我的建议是如果目标是“稳妥运行、高分通过”Thymeleaf方案完全够用如果演示环境允许局域网访问并且你熟悉Vue再考虑前后端分离。1.3 项目目录结构与模块划分目录结构是项目开发的骨架它比很多新手想象的更重要。一个清晰的分层结构一半的功能够少出问题。我用典型的分层结构做演示大家可以直接套用src/main/java/com/example/volunteer ├── controller │ ├── ActivityController.java │ ├── UserController.java │ ├── EnrollController.java │ └── AdminController.java ├── service │ ├── ActivityService.java │ ├── UserService.java │ └── EnrollService.java ├── mapper │ ├── UserMapper.java │ ├── ActivityMapper.java │ └── EnrollMapper.java ├── entity │ ├── User.java │ ├── Activity.java │ └── Enroll.java ├── dto │ └── EnrollDetailDTO.java ├── common │ ├── Result.java │ ├── GlobalExceptionHandler.java │ └── JwtUtils.java └── config ├── MybatisPlusConfig.java ├── WebMvcConfig.java └── InterceptorConfig.java这个分层其实就是一个标准的三层架构Controller接请求、Service写业务逻辑、Mapper操作数据库。Controller层要“瘦”只负责参数接收、调用Service、封装结果返回Service层是核心所有业务校验、数据组装都放在这里Mapper层只做持久化操作不要在Mapper里写业务判断。项目规模不大时不要引入额外的复杂设计模式保持简单直接。common包里放的是全局统一响应体Result、全局异常处理器和工具类这些是提升开发体验的标配。Result用泛型封装code、msg、data三个字段每个接口都返回这个结构前端只管判断code是否为200别的不需要关心。配合GlobalExceptionHandler捕获业务异常和校验异常一个非法参数进来时返回的是友好的错误提示而不是一坨500错误页面。config包里的WebMvcConfig和拦截器配置要预留好。接口校验登录状态的地方可以放在HandlerInterceptor里或直接用JWT拦截器。实际经验是先别在项目一开始就写一堆拦截规则等登录模块跑通后再根据接口的实际访问需求一条一条加白名单和拦截规则这样调试定位问题时头脑更清晰。2. 数据库设计与核心表结构数据库设计这个环节最容易看出一个人是不是真做过项目。表建得不好后面写接口时处处难受。校园志愿者服务平台虽然简单但表结构必须把几个核心关系理清楚用户和活动的关系是报名关系一个用户可以报名多个活动一个活动可以被多个用户报名活动组织方和管理员的关系通常用用户表的角色字段表示时长数据可以由管理员手动录入也可以通过签到签退时间自动计算。下面把我沉淀下来的一套健壮且常见的表结构设计方案拆开来说。2.1 数据表设计思路先画业务关系再建表建表之前先想想有几条核心链路。场景化描述一下学生浏览活动列表找到感兴趣的活动点击报名报名后管理员在后台看到本次活动的报名列表审核通过或拒绝活动开始后学生签到签退系统或管理员录入志愿时长最后学生可以在个人中心看到自己累计的时长、参与过的活动记录。这个链路涉及四张核心表用户表、活动表、报名表、时长记录表。如果还要扩展就是公告表、分类表但核心跑通第一个版本四张表足矣。表与表之间的外键关系我建议不在数据库层面强约束而是在代码里用逻辑外键维护。为什么因为课设项目经常要跑测试数据数据库层面的外键约束在删除、修改时特别容易触发异常直接导致接口报错。用逻辑外键可以降低排查成本开发期代码里把userId传对就行。当然在表设计文档中最好还是把关系图画出来答辩用来解释。每张表都带上create_time、update_time、deleted这三个通用字段这是个非常好的习惯。deleted是逻辑删除标志MyBatis-Plus配置了逻辑删除后调用deleteById时实际执行的是UPDATE ... SET deleted1这样数据不会真正丢失对“数据安全”这个答辩问题也能给出一个合理的技术方案。在给用户答复时这也是一个正式的系统设计点。2.2 用户表、活动表、报名表的核心字段用户表字段设计如下这是多个项目沿用迭代后的结果。字段名类型说明idbigint主键自增usernamevarchar(50)登录账号唯一索引passwordvarchar(100)BCrypt加密后的密码nicknamevarchar(50)显示昵称avatarvarchar(255)头像路径roletinyint0-学生1-管理员student_novarchar(30)学号便于统计phonevarchar(20)手机号statustinyint0-正常1-禁用creditint信用积分可空create_timedatetime创建时间update_timedatetime更新时间deletedtinyint逻辑删除标志密码字段一定不能存明文用Spring Security的BCryptPasswordEncoder或者JBCrypt都行。这一步能堵住安全性方面的追问。我习惯用BCrypt因为它的哈希结果自带盐值相同密码两次加密结果也不同并且matches方法校验旧密码非常方便。活动表的关键字段是标题、封面图、详情描述、活动地点、活动时间、报名截止时间、最大报名人数、已报名人数、状态、审核状态。这里的几个时间字段很考验业务理解。举例来说“活动开始时间”和“报名截止时间”要区分开很多人做一个活动表就只放一个activity_time结果到了判断“是否还能报名”的时候无处下手。这是我在实际答疑里发现非常普遍的问题。报名表结构更偏向中间表但不要只保存活动ID和用户ID那样信息量太低了。需要额外包含报名时间、报名状态、签到时间、签退时间、志愿服务时长、审核备注。CREATE TABLE enroll ( id bigint PRIMARY KEY AUTO_INCREMENT, activity_id bigint NOT NULL, user_id bigint NOT NULL, status tinyint DEFAULT 0 COMMENT 0-待审核 1-已通过 2-已拒绝 3-已完成, sign_in_time datetime NULL, sign_out_time datetime NULL, duration_minutes int DEFAULT 0, remark varchar(255), create_time datetime, update_time datetime, deleted tinyint DEFAULT 0 );状态字段直接使用tinyint数字映射不要存中文。中文状态是给人看的不是给程序用的程序里的常量类用STATUS_PENDING0这类定义提升可读性。如果用字符串存状态后面写统计SQL时会有写不完的CASE WHEN。2.3 初始化数据库脚本与测试数据数据库初始化文件建议同时提供schema.sql和data.sql前者建表后者插入测试数据。很多开源项目的经验是测试数据能不能安全地提供出来决定了项目快速跑起来的顺畅程度。我的建议是写一批贴近实际的数据比如管理员账号admin/admin123普通学生账号student/123456密码存BCrypt加密串在活动表里混着放“未开始、报名中、已结束、已满员”的各种状态报名表里也造一些不同状态的数据这样后端开发测试时各状态都能直接看到效果。测试数据的里程碑意义在于“接口第一次联调的时候不用边敲边造数据”。绝大多数课设项目的失败不是代码写不出来而是连测试数据都没有前端页面上永远一片空白根本没法给老师演示。数据库字符集用utf8mb4不要再用utf8。utf8在MySQL里是最大3字节遇到生僻字、emoji就会报错或者乱码。utf8mb4才是完整的四字节UTF-8。这个问题在用户昵称、活动名称里非常容易踩雷。时间字段建议统一用datetime不用timestamp。datetime的范围大到9999年不存在2038年问题。配合MyBatis-Plus的TableField(fill FieldFill.INSERT)自动填充创建时间可以省掉在每个Service里手动setCreateTime的体力活。自动填充的处理器需要实现MetaObjectHandler重写insertFill和updateFill即可。3. 开发环境搭建与Spring Boot配置开发环境是整个项目里最容易被轻视的部分。很多人觉得环境装好了就能开写实际上很多作业失败的案例就是把时间浪费在了环境不一致上。什么“JDK装了两个版本”“Maven仓库源没改”“IDEA Lombok插件没装”之类的问题完全可以在一开始靠清单式配置完全规避掉。3.1 从JDK、Maven到IDEA的一站式配置如果机器上已经装了多个JDK建议把不需要的版本卸掉至少要保证JDK8是JAVA_HOME指向的那个版本。这步可以通过命令行快速验证java -version echo $JAVA_HOME mvn -vMaven的安装位置不重要重要的是修改仓库配置。建议直接在用户目录下的settings.xml里设置阿里云镜像否则从Maven中央仓库下载依赖速度会让人崩溃。配置代码很简单mirror idaliyunmaven/id mirrorOf*/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirrorIDEA里则需要注意两个点一是把“Build Tools/Maven”里的User Settings与Maven的settings.xml关联否则IDEA会用自带配置镜像不生效二是设置好项目的Project SDK为JDK1.8Modules里的Language level也要逐模块匹配。少了第二步会出现代码不报错但编译不过的怪现象。开发环境配置这块我要多说一嘴数据库连接工具建议直接用IDEA自带的Database面板或者Navicat收费版免费的用户DBeaver也足够。对于只用MySQL的情况这些工具的智能提示能帮你避免手写字段名拼写错误。我见过太多因为字段名拼错导致查不出数据的案例掏出数据库工具看真实表结构比盯着代码发呆效率高得多。3.2 application.yml配置文件详解Spring Boot之所以被吹成“开箱即用”配置文件的规范功不可没。一个合理的application.yml应该包含数据源、MyBatis-Plus、日志级别、服务端口、文件上传路径等几大块。server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/volunteer?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: 123456 servlet: multipart: max-file-size: 10MB max-request-size: 20MB mybatis-plus: mapper-locations: classpath:mapper/*.xml configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl map-underscore-to-camel-case: true global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0几个配置的含义一定要说清楚。url里必须有serverTimezoneAsia/Shanghai否则MySQL 8.0的驱动会报时区异常这是很多人第一次启动项目就挂掉的原因。还有一个细节useSSLfalse是为了避免本地开发时出现证书警告生产环境则可以按需打开。map-underscore-to-camel-case建议设为true这样数据库的student_no字段能自动映射到Java bean的studentNo不用在每个字段上写TableField。MyBatis-Plus的逻辑删除配置同时必须保证实体类里确实存在deleted字段并且要加上TableLogic注解缺失任何一个都会导致“逻辑删除配置不生效”。配置里的log-impl设置为StdOutImpl可以把每条执行的SQL打印到控制台。开发阶段强烈推荐打开定位接口查询问题基本就靠它了。上了生产就没必要打印所有SQL可以通过日志级别控制例如设置成org.mybatis: warn。3.3 配置拦截器、异常处理器与统一返回结果把登录校验做在拦截器里是这个项目绕不开的环节。最简单的方案是实现一个HandlerInterceptor在preHandle里判断用户是否已登录通过HandlerMethod拿到当前请求的Controller方法上有没有PassToken注解没有就校验Header里带的token。public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { if (!(handler instanceof HandlerMethod)) { return true; } HandlerMethod method (HandlerMethod) handler; if (method.hasMethodAnnotation(PassToken.class)) { return true; } String token request.getHeader(Authorization); // 校验token不通过则返回401 ... return true; } }敲定拦截规则时要注意两个典型坑第一登录接口、注册接口、活动列表接口这些不需要登录就能访问的接口记得加PassToken注解第二静态资源路径要放行不然页面会出现“登录页加载了但CSS全404”的诡异问题。WebMvcConfig里通过addInterceptor和addPathPatterns(/**)注册再excludePathPatterns(/login, /register, /css/**, /js/**, /img/**)就能把事情处理干净。全局异常处理器我通常会定义一个自定义业务异常类ServiceException extends RuntimeException。Service里校验失败时直接抛出全局异常处理器统一捕获返回Result对象。这一步能在答辩时展示你对项目中异常处理机制有完整思考是加分项。全局统一返回体大概长这样public class ResultT { private Integer code; private String msg; private T data; }接口的返回格式从头到尾保持一致。前端不管是jQuery的$.ajax还是Vue的axios判断逻辑都只有一套这种一致的体验省心程度很高。4. 核心功能落地活动发布、报名与审核完成了基础架构进入真正的业务模块。这个部分内容量最大最容易出现“每个功能都知道但代码就是写不完”的情况。核心的取舍原则是先打通主链路再补次要功能。4.1 活动模块列表分页与详情展示的技术细节活动列表页是用户打开系统后看到的第一个页面也是承载数据最大的接口。它需要支持分页、按活动状态筛选、按关键字搜索还可以按发布时间排序。用MyBatis-Plus分页时先注入分页插件然后PageActivity page new Page(current, size); LambdaQueryWrapperActivity wrapper new LambdaQueryWrapper(); wrapper.eq(Activity::getStatus, status) .like(StringUtils.hasText(keyword), Activity::getTitle, keyword) .orderByDesc(Activity::getCreateTime); activityService.page(page, wrapper);分页之后返回的数据结构要封装一下包含当前记录、总条数、每页大小前端才能渲染出分页组件。这个PageHelper类型不要和PageHelper插件搞混了MyBatis-Plus有自己的一套不兼容PageHelper。活动详情接口的设计要点是“一次性返回该展示的全部字段”并在接口层合并关联数据。比如活动详情里要显示报名人数和当前用户是否已报名这两条信息一条来自活动表的“已报名人数”字段一条来自报名表里的查询。前端不希望因为一个详情页调三四个接口。我的习惯是在Service里做聚合通过一个getDetailById(activityId, userId)中的userId参数来判断当前登录用户有没有报名该活动。这样前端只调一次就拿到全部展示数据。上传活动封面图这部分需要把图片保存到本地目录并返回一个可供前端访问的URL。Spring Boot可以自定义一个本地资源映射Configuration public class WebMvcConfig implements WebMvcConfigurer { Value(${file.upload-path}) private String uploadPath; Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/upload/**) .addResourceHandler(file: uploadPath); } }这种静态资源映射方案不是空穴来风而是所有Spring项目里最常规的做法。本地测试时上传图片后可以直接通过http://localhost:8080/upload/xxx.png访问。在活动模块还有一点值得提醒管理员创建活动的接口要在参数上加上Validated校验注解对标题不能为空、活动开始时间晚于当前时间、最大报名人数为正整数这些基本规则做防呆校验。用注解校验能避免把大量if判断堆在Controller里也让前端能拿到统一的错误提示。4.2 报名模块事务、状态机和并发问题报名是整个系统里最需要仔细琢磨的业务因为它在同一个操作里要同时修改两张表的数据报名表插入一条新记录活动表的已报名人数加一。这两个操作必须放在同一个事务里否则会出现“活动名额定满了但报名记录查不到”的矛盾数据。事务注解直接打在Service方法上Transactional(rollbackFor Exception.class) public void enroll(EnrollRequest request) { // 1. 校验活动状态 // 2. 检查活动未截止 // 3. 检查用户没有重复报名 // 4. 检查人数是否已满 // 5. 插入报名记录 // 6. 更新活动已报名人数 }报名状态的流转是状态机思路一个报名记录有待审核、已通过、已拒绝、已取消、已完成几种状态。用户操作能够触发的状态变化是报名创建后是待审核状态管理员点击通过或拒绝用户取消则变成已取消。活动管理人点击报名记录里的签到就把状态改为已完成。状态切换逻辑写在Service层用常量定义状态值不要散落在Controller里。报名接口还有一个隐藏问题多人同时抢着报名最后一个名额的时候怎么避免超卖最简单的做法是用数据库的行锁在更新活动人数时使用条件更新int count activityMapper.updateEnrollCount(activityId); if (count 0) { throw new ServiceException(活动名额已满); }这个更新SQL是UPDATE activity SET enroll_count enroll_count 1 WHERE id ? AND enroll_count max_count通过受影响行数来判断是否更新成功。这个方案虽然简单但在答辩时足够展示你对并发问题有基本认知。如果你想演示得再高级一点可以在报名Service上加Transactional并使用悲观锁也可以引入Redis的分布式锁做防重不过对课设来说条件更新已经达到目的了。4.3 管理员后台活动审核、用户管理和数据统计管理端的设计重点不是功能堆叠而是“怎么从一堆报表里快速看出业务全貌”。活动管理要支持增删改查同时可以对活动进行上下架操作。下架一个活动之后前端就不要出现在活动列表里了用户再访问详情页时也要给提示。这个上下架状态要独立于活动的发布状态很多系统会把这两者的概念混在一起结果是管理员想隐藏一个活动但被迫必须改活动开始时间。用户管理模块里管理员可以查看所有学生用户支持根据学号或姓名搜索可以禁用/启用账号。禁用之后该用户无法登录已经存在的报名记录不受影响这符合校园场景的直觉。我把禁用逻辑放在拦截器校验token之前的取用户信息环节这样每次请求都能实时感知账号状态。数据统计模块是给答辩增加亮点的地方。统计维度可以包括本周新增活动数量、本周新增报名人数、各院系时长排名、最热门活动Top10、每月活动数趋势。这些统计结果用一条GROUP BY SQL在MyBatis的XML里拼出来返回一个Map或DTO列表。统计接口单独放在一个StatisticsController下不要让用户的报名接口和统计接口混在同一个Controller里。这个模块不需要很复杂但一定得在答辩前准备好演示数据真正把图表的数字展示出来。前端页面如果采用Thymeleaf管理端的页面布局可以用一个公共的admin_layout.html片段把侧边栏、顶栏、内容区抽象出来。如果采用前后端分离那管理端就是Vue工程里另建一套路由和页面比较费工。在这个项目里我的建议是优先做“能用”的Bootstrap管理界面把精力花在功能完成度上。5. 调试部署方案与常见问题速查到了这个阶段项目功能基本写完了接下来从调试到部署是确保项目能顺利通关的临门一脚。我把这部分单独列出来因为它才是决定项目成败的关键。5.1 本地调试技巧从控制台SQL入手调试Spring Boot项目第一步就要会看控制台日志。前面已经配置了MyBatis的SQL输出每个接口执行了什么SQL、传了什么参数都会打印出来。排查问题时比代码走读更好用的路径是先看这条SQL是否跟业务预期一致再反向检查参数封装。举一个典型案例分页不生效。前台传来第一页每页10条返回结果却有100条。这时如果看控制台打印的SQL会发现没有LIMIT关键字原因基本就是分页插件没配置。我一般在本地接一个IDEA的断点把请求拦截住看Page对象里的字段是否被正确赋值。社区调试的另一个好习惯是搭一个全局异常处理器并在里面打印完整的异常堆栈日志。此时日志就是你的主调试工具。第一个版本上线时调试路线上往下走通过log.error记录每个Service的关键路径能够大幅减少查问题的时间开销。如果接口逻辑简单到了不需要断点的程度直接使用curl配合IDEA的HTTP Client也是效率很高的路径。在项目根目录建一个requests.http文件写好GET和POST请求样例每次启动项目后直接点发送按钮比打开Postman找请求记录要快得多。5.2 部署方案jar包、Docker Compose以及Nginx部署是整个项目的“最后十公里”。我见过很多开发时一切正常、部署时上不了台面的案例几乎都是因为生产环境的JDK、MySQL、端口、配置路径和开发环境不一致。一套相对稳的部署路径如下Maven打jar包先执行mvn clean package -DskipTests在target目录里生成jar包。准备好一台装好JDK1.8的服务器用java -jar volunteer.jar直接启动。如果数据库和应用部署在同一台服务器创建一个独立的MySQL用户授权给对应的数据库别用root直接部署。如果你熟悉Docker推荐使用docker compose编排。写一个简单的docker-compose.yml分别定义MySQL服务和应用服务。version: 3 services: mysql: image: mysql:5.7 environment: MYSQL_ROOT_PASSWORD: root123 MYSQL_DATABASE: volunteer ports: - 3306:3306 volumes: - ./init.sql:/docker-entrypoint-initdb.d/init.sql app: build: . depends_on: - mysql ports: - 8080:8080这里有个经验之谈生产环境不要再使用默认的root/123456一定设置独立账号。同时Docker容器里初始化数据库强烈建议在docker-entrypoint-initdb.d目录挂载初始化脚本这样容器第一次启动时会自动执行建表语句实现“开箱即用”。部署过程中最经常遇到的坑有三个。第一个是jar包启动时提示“端口被占用”排查方式是netstat -tunlp | grep 8080找到占用进程处理掉。第二个是数据库连接不上检查MySQL服务是否启动再检查服务器的3306端口是否被防火墙拦截阿里云服务器还要检查安全组规则。第三个是启动后日志报Invalid bound statement这是MyBatis的Mapper XML文件没被扫描到检查mapper-locations是否与存放XML的实际路径匹配。前端是前后端分离项目时还需要加Nginx配置。Nginx负责两件事第一托管打包好的前端静态文件第二把/api/开头的请求反向代理到后端的http://localhost:8080。配置写法如下server { listen 80; server_name localhost; root /opt/volunteer-frontend/dist; index index.html; location /api/ { proxy_pass http://127.0.0.1:8080/; } }这段配置中的proxy_pass结尾带/表示会把请求地址里/api前缀去掉再转发给后端。如果后端Controller确实需要保留/api前缀就去掉末尾的/。这个细节直接决定Nginx转发是否404是很多新手栽跟头的地方。5.3 高频错误排查实录把常见问题整理成一个速查表在实战中非常见效。现象原因解决方案启动报Access denied for user数据库用户名或密码错误检查application.yml里的账号密码确认权限启动报Unknown database数据库不存在先执行建库语句CREATE DATABASE volunteer页面样式全乱静态资源被拦截拦截器放行/css/**、/js/**、/img/**列表查询慢且数据重复分页插件未生效注册PaginationInnerInterceptor到MyBatis-Plus容器中文乱码URL或数据库字符集不一致数据库统一为utf8mb4连接串加characterEncodingutf8POST请求返回405路由方法映射错误检查Controller的GetMapping与PostMapping是否匹配前端提示跨域前后端分离时端口不一致后端添加CORS配置或前端使用Nginx代理上传图片后无法访问静态资源映射未配置在WebMvcConfig中为上传目录配置addResourceHandlers部署后显示404Nginx location转发路径不对检查proxy_pass末尾是否有斜杠以及前端路由的base路径登录校验不通过数据库密码加密方式改变BCrypt加密逻辑与注册接口校验逻辑保持一致5.4 答辩演示环境准备的最后提醒答辩或验收不是开发环境不能让评分老师看着你现场敲代码。演示前把一个最小环境跑通一个已经启动的后端进程一个预先导入测试数据的MySQL一个浏览器里已经打开的页面。把所有演示数据准备充分比如数据库里预置十多个活动、若干用户、各种报名状态这样演示的时候切页面才有内容看而不是“点击查询没数据”。另外提前把各端口、账号密码整理成一张备忘表放在旁边或者贴在演示机桌面上。比如后台管理员的账号和密码、普通测试学生的账号和密码、数据库连接的用户名密码。实际操作中一旦卡壳一个明确的备忘表往往能救急。如果老师可能会问“你这个系统怎么保证安全”准备两个方向一是密码BCrypt加密存储、不落明文二是用户输入经过全局XSS过滤和参数校验。从项目里把这两点抽出来单独讲比临时背概念要靠谱得多。最后再分享一个操作层面的体会这类校园系统项目在提交前一定反复检查服务器上是不是能跑起来。我自己吃过一次亏开发机上是开发库数据顺顺当当打包换到服务器直接起不来原因是MySQL安装时没设utf8mb4初始化数据全是乱码。从那以后我把“服务器首次启动”列成项目结束前的必查项宁可多花一个小时不再抱着侥幸心理直接上演示台。