做了几年开发,前后端分离的项目没少碰,但要说哪种项目最适合拿来练手和复用,语言考试信息报名系统绝对算一个。业务闭环完整、权限边界清晰、数据模型典型,而且从注册、报名、审核到成绩查询,整条链路天然适合拆成一套标准的前后端分离架构。我这次用SpringBoot+Vue+MyBatis+MySQL把这套系统完整实现了一遍,源码和部署教程都整理好了。这篇就把整个项目的设计思路、核心实现、部署细节和踩坑记录一次讲清楚,想照着写一个类似系统的朋友可以直接参考。
1. 项目整体思路与技术选型
1.1 为什么这个系统一定要用前后端分离
先聊个基础问题:语言考试报名系统这种业务,用传统JSP或者Thymeleaf服务端渲染不行吗?能行,但会很痛苦。
这类系统的特点非常明显:考生端和管理端的页面形态差异巨大,考生看的是报名流程、缴费状态、准考证打印,管理员看的是数据表格、审核操作、统计分析。如果全部由后端渲染,每次页面切换都要走一次服务端视图解析,前后端代码耦合在一起,改一个按钮样式都可能要动Java代码,后期维护是灾难。
前后端分离之后,后端只负责提供JSON接口,前端拿到数据自己渲染。Vue负责页面交互和路由,SpringBoot只处理业务逻辑和数据,两者通过HTTP协议通信。这样做的直接收益有三个:一是前端开发和后端开发可以完全并行,不用互相等;二是同样的接口可以同时服务浏览器端和后续的移动端,比如以后要做小程序报名通道,后端接口零改动;三是部署的时候前端静态资源扔到Nginx,后端打成jar包单独跑,互不影响,扩容也方便。
我见过不少团队把报名系统做成服务端渲染,到了报名高峰期几十万考生同时刷页面,数据库和模板引擎全被拖垮,临时加机器还只能整包复制,相当被动。前后端分离以后,前端静态页面直接用CDN加速,后端接口做集群,性能瓶颈的定位和处理都清晰得多。
1.2 SpringBoot、Vue、MyBatis、MySQL的组合逻辑
技术选型这件事,很多时候不是选最好的,而是选最稳的。SpringBoot+Vue+MyBatis+MySQL这套组合,放在今天依然是中小型管理系统的黄金搭档。
- SpringBoot负责后端骨架。它解决了Spring家族配置地狱的问题,内嵌Tomcat,一个jar包就是整个服务,应用启动快,生态成熟。报名系统涉及的定时任务、邮件通知、Excel导出这些功能,SpringBoot都有现成的starter可以引入。
- Vue负责前端交互。响应式数据绑定让报名表单、审核列表这类强交互页面写起来非常顺手,组件化开发方式也让页面复用变得容易。我这次用的是Vue3+Vite,构建速度比Vue2的webpack方案快一大截,开发体验提升明显。
- MyBatis负责数据库访问。相比JPA那种全自动ORM,MyBatis的半自动映射对SQL可控性更强。报名系统里有大量复杂的统计查询,比如按考试类型统计报名人数、按考点查看座位余量,这些SQL用MyBatis的XML文件管理得一目了然,调优也方便。
- MySQL负责数据持久化。报名系统的数据量充其量到百万级别,MySQL完全扛得住,成熟的索引优化和主从复制方案足够支撑业务增长,而且部署运维成本低,团队里的每个人都能上手。
这套技术栈还有一个隐性的好处:招人容易。国内大部分Java开发都熟悉这套组合,项目交接到别人手里,不需要重新学一套冷门框架。
1.3 项目目录结构一览
我习惯从目录结构开始规划项目,结构定了,开发顺序就清楚了。这份源码里前后端分两个目录:
code复制exam-registration-server # 后端SpringBoot工程
├── src/main/java/com/exam
│ ├── controller # 接口层
│ ├── service # 业务逻辑层
│ ├── mapper # MyBatis数据访问接口
│ ├── entity # 实体类
│ ├── config # 配置类(跨域、拦截器、分页等)
│ ├── common # 通用返回结构、异常处理、工具类
│ └── security # JWT登录认证与权限控制
├── src/main/resources
│ ├── mapper # MyBatis XML映射文件
│ └── application.yml # 核心配置
└── pom.xml
exam-registration-web # 前端Vue工程
├── src
│ ├── api # 接口请求封装
│ ├── router # 路由配置
│ ├── store # Pinia状态管理
│ ├── views # 页面组件(考生端+管理端)
│ ├── components # 公共组件
│ └── utils # 工具函数和axios实例
├── vite.config.js # 开发代理与构建配置
└── package.json
这个结构是按照职责分层来拆的,后端严格遵循三层架构:Controller只做参数接收和结果返回,Service层处理业务规则,Mapper层专注数据访问。前端按页面功能分为考生端和管理端两部分,通过路由和权限控制区分访问范围。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心业务与数据库设计
2.1 功能模块拆解:考生端和管理端双视角
报名系统的业务流程要先理清楚,再动手写代码。我从用户角色角度把功能拆成两条线。
考生端的功能设计:
- 注册登录:手机号+密码注册,密码用BCrypt加密存储。登录后签发JWT Token,前端后续请求都带上这个Token。
- 考试报名:选择正在开放报名的考试计划,填写个人信息、上传证件照、选择考点,提交后生成报名记录。
- 报名状态跟踪:考生能实时看到自己的审核状态,待审核、审核通过、审核驳回、已缴费这几个状态一目了然。
- 准考证下载:审核通过并缴费后,系统生成准考证,考生可在线查看和打印。
- 成绩查询:考试结束后管理员录入成绩,考生在个人中心查询成绩和合格状态。
管理端的功能设计:
- 考试计划管理:管理员创建考试,设置报名开始时间、结束时间、考试时间、考试费用、报考条件等参数。
- 报名审核:管理员逐条审核考生的报名表单,确认照片、证件信息是否符合要求,通过或驳回都要写审核意见。
- 考点与考场管理:维护考点信息,为每个考试分配考场容量,系统自动控制报名人数不能超过容量上限。
- 成绩管理:考试结束后导入或录入成绩,支持批量录入和单个修改。
- 数据统计:按考试类型、时间维度查看报名人数、审核通过率、缴费金额等统计数据。
两条业务线之间通过考试计划这个核心实体连接起来。考生报名依赖于管理员创建的考试计划,成绩又挂在具体的考试计划下面。设计的时候把这种关联关系理顺了,后面的表结构和接口定义就顺理成章了。
2.2 核心数据表设计
数据库是报名系统的地基,表结构设计合理,业务逻辑写起来就顺手。这套系统里我设计了七张核心表,下面把最关键的几张拿出来说说。
用户表(user):
| 字段名 | 类型 | 说明 |
|---|---|---|
| id | bigint | 主键,自增 |
| phone | varchar(20) | 登录手机号,唯一索引 |
| password | varchar(100) | BCrypt加密后的密码 |
| role | tinyint | 角色:0管理员,1考生 |
| status | tinyint | 状态:0禁用,1正常 |
| create_time | datetime | 创建时间 |
考试计划表(exam_plan):
| 字段名 | 类型 | 说明 |
|---|---|---|
| id | bigint | 主键 |
| exam_name | varchar(100) | 考试名称,如“2025年上半年英语四级” |
| exam_type | varchar(50) | 考试类型编码 |
| register_start_time | datetime | 报名开始时间 |
| register_end_time | datetime | 报名结束时间 |
| exam_time | datetime | 考试时间 |
| fee | decimal(10,2) | 报名费用 |
| total_quota | int | 总报名名额 |
| enrolled_count | int | 已报名人数 |
| status | tinyint | 状态:0草稿,1开放报名,2报名结束,3考试完成 |
报名记录表(registration_record):
| 字段名 | 类型 | 说明 |
|---|---|---|
| id | bigint | 主键 |
| user_id | bigint | 关联用户表 |
| plan_id | bigint | 关联考试计划表 |
| id_card | varchar(20) | 身份证号 |
| real_name | varchar(50) | 真实姓名 |
| photo_url | varchar(255) |
