SpringBoot+MyBatis打造新生报到系统：从数据库设计到并发兜底

简介：SpringBoot大学新生报到系统是一份面向计算机专业毕业设计及Spring Boot实战学习的完整工程源码包，覆盖学生信息管理、报到流程管理和宿舍分配等核心模块。压缩包共561个文件，约16.02MB，其中包含123个Java源码、93个Vue页面、41个JS脚本、161个SVG图标、CSS样式、SQL脚本以及bat运行脚本等，按Maven工程结构组织，便于理解前后端分离、RESTful接口与数据库持久化设计。目前已有77人浏览/学习，可参考价值较高。借助源码、数据库表结构及vue.bak等备份文件，学习者能梳理Spring Boot框架集成、Vue前端交互、本地一键部署流程，也可从需求分析、系统设计、安全性、可扩展性等环节获得毕业设计选题的直接落地参考。整体资源适合需要完整项目练习、二次开发或准备答辩的读者，能有效提升软件工程综合实践能力。

1. 为什么新生报到系统要选 SpringBoot 来做

每年八月底到九月初，高校信息中心的工单量会翻倍。新生报到牵扯的不是单一业务：学生信息采集、报到状态流转、宿舍分配、缴费核验、分班与学号生成，每条线都涉及一致性和时效性。用传统 Servlet 加 JSP 做，开发周期赶不上招生日程；用脚本语言拼，事务和审计又不好交代。SpringBoot 在这个场景里近乎行业默认，它的 starter 机制能快速装配 Web、数据访问、安全控制和日志能力，配合 MySQL 做关系型存储，可以覆盖报到现场的并发写与复杂查询。下面按一套完整落地路线来讲：技术选型、数据库设计、核心模块实现到部署验证，把迎新报到这类系统的典型做法拆开看。代码和配置给出的是可直接套用的通用形式，版本选择、参数设定和表结构调整空间都标出来。

2. SpringBoot 技术选型与分层架构

2.1 为什么新生报到适合 SpringBoot 加 MyBatis 的组合

新生报到系统的关键约束不是并发量，而是流程边界多、数据字段杂、现场改动快。SpringBoot 2.7.x 和 3.x 都合适，具体看团队的 JDK 基础。3.x 强制 JDK 17+，如果机房服务器还停留在 JDK 8，就选 2.7.x 系列。持久层用 MyBatis-Plus 比较常见，因为报到系统里大量操作是单表 CRUD 加少量报表查询，BaseMapper 能减少一大半样板代码；遇到跨表统计再写 XML 自定义 SQL，不像全自动 ORM 那样容易产生 N+1 查询。

代码组织按 controller、service、mapper、entity 四层拆。现场报到会用到事务边界：学生确认报到、宿舍分配、班级写入三个动作必须原子性执行，这是 @Transactional 的典型场景。controller 只做参数校验和结果包装，service 写业务规则，mapper 只管 SQL，entity 做字段映射。

2.2 初始化 springboot 工程的依赖清单

新建工程时最怕版本漂移。下面这份 pom.xml 片段是验证过的组合：SpringBoot 2.7.18 加 MyBatis-Plus 3.5.5 加 MySQL 8.0 驱动，能在绝大多数校内服务器上直接编译运行。

<parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.7.18</version> <relativePath/> </parent> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-validation</artifactId> </dependency> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.5</version> </dependency> <dependency> <groupId>com.mysql</groupId> <artifactId>mysql-connector-j</artifactId> <version>8.0.33</version> </dependency> </dependencies>

SpringBoot 2.7.18 是 2.x 系列的最后一个社区维护版本，对 JDK 8、11、17 都兼容。MyBatis-Plus 3.5.5 的分页插件开箱即用，不用手算 limit 偏移量。mysql-connector-j 8.0.33 对应 MySQL 8.0 的 caching_sha2_password 认证方式，5.7 库也能正常连接。

2.3 application.yml 的 4 组必要配置

yml 配置直接影响能否启动。以 2.7.x 为例，最少要配数据源、MyBatis-Plus 的 mapper 路径、SQL 日志级别和 context-path 上下文路径。

server: port: 8080 servlet: context-path: /register spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/university_register?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false username: root password: "your_password" mybatis-plus: mapper-locations: classpath*:mapper/**/*.xml configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0 logging: level: com.example.register.mapper: debug

serverTimezone=Asia/Shanghai 必须显式写，否则 MySQL 8.0 的驱动会在连接阶段报时区错误。logic-delete-field 做软删除，新生信息填错作废时不能物理删行。log-impl 打开后 MyBatis 执行的每条 SQL 都会打到控制台，联调阶段排查参数绑定问题很高效。context-path 统一加 /register 前缀，后面接 nginx 或网关时路径转发规则会清晰很多。

2.4 初始化数据库与管理员账号的 SQL 脚本

数据库脚本要能重复执行。CREATE TABLE IF NOT EXISTS 和 INSERT IGNORE 是两种常用的幂等写法。

CREATE DATABASE IF NOT EXISTS university_register DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE university_register; CREATE TABLE IF NOT EXISTS sys_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '用户ID', user_type TINYINT NOT NULL DEFAULT 2 COMMENT '1-管理员,2-辅导员,3-学生', username VARCHAR(64) NOT NULL UNIQUE COMMENT '登录名', password VARCHAR(128) NOT NULL COMMENT 'BCrypt密文', real_name VARCHAR(32) COMMENT '姓名', phone VARCHAR(20) COMMENT '手机号', created_at DATETIME DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP ) ENGINE=InnoDB COMMENT='系统用户表'; INSERT IGNORE INTO sys_user (user_type, username, password, real_name) VALUES (1, 'admin', '$2a$10$LQHYGmBZxM9xVY5NqG5QWuVbBx9O9UcPTBN5BLoAvHZz5dR5rv0e2', '系统管理员');

SQL 里直接放 BCrypt 密文只适合开发环境。生产项目里我通常会写一个 CommandLineRunner，首次启动时用 BCryptPasswordEncoder 现场生成管理员密码并打印到日志，人工确认后再把 SQL 里的密文替换掉，避免所有环境共用同一个默认密码。INSERT IGNORE 依赖 username 的唯一索引，重复执行时不会报错也不会覆盖已有记录。

提示：生产环境的默认管理员密码一定要在首次登录后强制修改，别依赖任何 SQL 里写死的密文。

3. 数据库设计：新生报到核心表结构与字段关系

3.1 数据流向与分组建表

新生报到系统的数据设计，核心是"学生主体加报到事件加周边资源"的三角结构。学生是主数据，报到的每一步都在往学生身上挂状态和关联记录。四组表划分：基础档案组 student、major_info、class_info；报到流程组 register_step、register_record；资源分配组 dormitory、dorm_bed；辅助记录组 payment_record、audit_log。分组理由是现场业务经常只改某一个组内的表，分组明确能降低不同模块同事协同维护时的认知负担。

3.2 student 表字段设计与索引选择

学生表是整个系统的地基。字段设计建议保留必要的扩展性，但别一开始就铺几十个列。常用字段组合如下：

CREATE TABLE student ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_no VARCHAR(20) NOT NULL UNIQUE COMMENT '学号，年份+专业代码+序号生成', name VARCHAR(64) NOT NULL, id_card VARCHAR(18) NOT NULL COMMENT '身份证号', gender TINYINT NOT NULL DEFAULT 0 COMMENT '0-男,1-女', major_code VARCHAR(10) NOT NULL COMMENT '录取专业代码', class_id BIGINT NOT NULL COMMENT '班级ID', phone VARCHAR(20), emergency_contact VARCHAR(64), emergency_phone VARCHAR(20), enroll_year INT NOT NULL COMMENT '入学年份', register_status TINYINT NOT NULL DEFAULT 0 COMMENT '0-未报到,1-线上确认,2-现场完成', deleted TINYINT NOT NULL DEFAULT 0, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, KEY idx_major (major_code), KEY idx_class (class_id), KEY idx_status (register_status, enroll_year) ) ENGINE=InnoDB COMMENT='新生信息表';

id_card 存储明文需要谨慎处理，生产环境通常会做列级加密或脱敏展示，这取决于学校的合规要求。register_status 加复合索引 idx_status，因为"按年份加报到状态筛选名单"是最常见的后台查询，单独查 enroll_year 基数不高，建单列索引收益有限。student_no 用唯一索引兜底，防止批量导入时重复。

3.3 报到流程与宿舍分配的状态机设计

报到流程不能只靠 student.register_status 一个字段。现场会存在"已缴住宿费但还没选床""报到了但照片缺""线上提交了但辅导员没审核"这类中间态。更合理的做法是拆一张报到环节子表，记录每个环节的完成人、完成时间和备注。

CREATE TABLE register_step ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_id BIGINT NOT NULL, step_code VARCHAR(32) NOT NULL COMMENT 'INFO_VERIFY/PAYMENT/DORM/BADGE', step_name VARCHAR(64) NOT NULL, status TINYINT NOT NULL DEFAULT 0 COMMENT '0-未开始,1-进行中,2-已完成,3-已驳回', operator_id BIGINT COMMENT '操作人ID', remark VARCHAR(255), completed_at DATETIME, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_student_step (student_id, step_code), KEY idx_step_status (step_code, status) ) ENGINE=InnoDB COMMENT='报到环节进度表';

UNIQUE KEY uk_student_step 保证同一个学生同一个环节只有一条记录。驳回时不要把记录删掉，而是把 status 改回 0 并清空 completed_at，这样后续可以继续流转。床位分配的防重复则依靠 dorm_bed 表的唯一索引，让数据库去拒绝第二个人分配同一张床，而不是靠应用层 if 判断。

3.4 统计报表的冗余字段与聚合表

首页大屏和后台报表喜欢按学院、按专业、按分数段做分组计数，如果每次都 join 现算，数据量上来后聚合查询会很费力。我的做法是在统计维度上做冗余：student 表预留 college_code 字段，和 major_code 一起维护；再建一张 register_daily_stat 按天汇总报到数，由定时任务每天凌晨写一次。现场大屏直接查统计表，数据有十几分钟延迟完全可接受。冗余带来的代价是写入时要多维护字段，但报到系统的写入频率本身不高，性价比是划算的。

3.5 表关系速览与数据迁移命令

下面这张表是实际项目里常用的表职责速览，方便不同角色的人快速定位改动点。

表名	职责	关键字段	数据量级
student	新生档案主表	student_no, major_code, register_status	万级
register_step	报到环节流水	student_id, step_code, status	十万级
dorm_bed	床位与分配关系	bed_no, student_id, room_id	千级
payment_record	缴费记录	student_id, amount, status	万级
audit_log	操作审计	operator_id, action, target_id	十万级

开发环境做数据迁移时，命令行比图形工具更稳定。常用导出导入命令如下：

mysqldump -uroot -p university_register --single-transaction --default-character-set=utf8mb4 > university_register_backup.sql mysql -uroot -p university_register < university_register_backup.sql

mysqldump 的 --single-transaction 参数对 InnoDB 表做一致性快照，不需要锁表，报到当天白天执行也不会影响现场操作。导入时如果报字符集错误，先检查终端自身的编码和导出文件是否一致，Windows 下经常在这里遇到坑。

4. 核心模块实现：SpringBoot 里的报到主流程代码

4.1 新生批量导入与 BCrypt 密码处理

报到系统的学生初始账号通常由学校统一生成。常见两种方案：管理员批量导入时生成初始密码，或者学生在线上报到页用身份证号加录取通知书号激活账号。多数项目选第一种，省事，但初始密码入库前必须做 BCrypt 哈希，否则容易成为批量撞库的突破口。

@Service public class StudentService { private final PasswordEncoder passwordEncoder = new BCryptPasswordEncoder(); @Transactional public void batchImportStudents(List<StudentImportDTO> list) { List<Student> students = list.stream().map(dto -> { Student s = new Student(); s.setName(dto.getName()); s.setIdCard(dto.getIdCard()); s.setMajorCode(dto.getMajorCode()); s.setEnrollYear(Year.now().getValue()); s.setStudentNo(generateStudentNo(dto.getMajorCode())); s.setRegisterStatus(0); String defaultPassword = StringUtils.right(dto.getIdCard(), 6); s.setPassword(passwordEncoder.encode(defaultPassword)); return s; }).collect(Collectors.toList()); studentMapper.insertBatch(students); } }

batchImportStudents 加 @Transactional 的原因：批量导入几千人时任何一条异常都应让整批回滚，否则会留下部分有账号部分没账号的中间状态。BCrypt 每次 encode 会生成不同的盐，所以校验密码必须用 passwordEncoder.matches(rawPassword, encodedPassword)，不能对两条密文做字符串比较。generateStudentNo 方法通常是年份加专业代码加四位自增序号，序号部分要查当天已有最大值，否则并发导入会撞唯一索引。

4.2 现场确认报到：一个事务写三张表

现场确认报到的接口是整个系统的核心路径。它同时更新学生状态、写报到环节流水、占用床位，三个动作必须在一个事务里完成。

@Transactional(rollbackFor = Exception.class) public void confirmRegister(Long studentId, Long operatorId, Long bedId) { Student student = studentMapper.selectById(studentId); if (student == null || student.getRegisterStatus() == 2) { throw new BusinessException("学生不存在或已完成报到"); } student.setRegisterStatus(2); studentMapper.updateById(student); RegisterStep step = new RegisterStep(); step.setStudentId(studentId); step.setStepCode("ON_SITE_VERIFY"); step.setStatus(2); step.setOperatorId(operatorId); step.setCompletedAt(LocalDateTime.now()); registerStepMapper.insert(step); DormBed bed = dormBedMapper.selectById(bedId); if (bed.getStudentId() != null) { throw new BusinessException("该床位已被占用"); } bed.setStudentId(studentId); dormBedMapper.updateById(bed); }

rollbackFor = Exception.class 是关键。Spring 的 @Transactional 默认只对 RuntimeException 回滚，如果业务方法抛出检查异常（例如导出文件时的 IOException），事务不会回滚，数据就会保持在半完成状态。床位占用这里先查后改存在并发窗口，所以生产环境的 dorm_bed 表还必须有唯一索引做兜底，见最后一章。

4.3 后台分页查询的 MyBatis-Plus 写法

后台管理页面里"查未报到学生""按专业查名单"都是高频条件查询。MyBatis-Plus 的 LambdaQueryWrapper 适合这类动态条件组合，比字符串拼接 SQL 安全得多。

@Override public Page<StudentVO> queryStudentPage(int page, int size, StudentQuery query) { Page<Student> pageInfo = new Page<>(page, size); LambdaQueryWrapper<Student> wrapper = Wrappers.lambdaQuery(); wrapper.eq(query.getMajorCode() != null, Student::getMajorCode, query.getMajorCode()) .eq(query.getRegisterStatus() != null, Student::getRegisterStatus, query.getRegisterStatus()) .like(StringUtils.hasText(query.getName()), Student::getName, query.getName()) .orderByDesc(Student::getCreatedAt); Page<Student> result = studentMapper.selectPage(pageInfo, wrapper); return convertToVO(result); }

eq 方法的第一个参数是布尔条件，为 false 时该条件不加入 SQL，避免空值参与查询。selectPage 会自动执行 COUNT 和 LIMIT 两条 SQL，不用手算偏移量。注意 Page 的第一页是 1 不是 0，前端传 current 参数时容易在这里出错。like 查询用 % 包裹，如果新生姓名包含 % 或 _ 通配符，需要先做转义，否则会查出预期之外的记录。

4.4 EasyExcel 导入新生名单的完整流程

批量导入在迎新系统里是必备功能。EasyExcel 是阿里开源库，读 Excel 时对内存的占用比 POI 原生方式低很多，几万行数据不会有明显压力。

@PostMapping("/import") public Result<Void> importStudents(@RequestParam("file") MultipartFile file) throws IOException { List<StudentImportDTO> list = EasyExcel.read(file.getInputStream()) .head(StudentImportDTO.class) .sheet() .doReadSync(); for (StudentImportDTO dto : list) { if (dto.getName() == null || dto.getIdCard() == null) { throw new BusinessException("模板中存在空行或必填字段缺失"); } } studentService.batchImportStudents(list); return Result.success(); }

doReadSync 是把整个 Sheet 一次性读入内存，适合十万行以内的场景；如果学校一次性导入超过十万行，要改成 ReadListener 一行行处理。StudentImportDTO 用 @ExcelProperty(value = "姓名", index = 0) 这类注解映射列顺序，模板列一调整就需要同步修改注解。校验空行放在接口层而不是 service 层，目的是快速返回业务提示，不在无效事务上浪费数据库连接。

5. SpringBoot 项目的打包部署与环境配置

5.1 用 profile 拆分开发、测试、生产三套配置

SpringBoot 打包前要重新审视配置分离。我会把 application.yml 按 profile 拆成 dev、test、prod 三份，启动时用参数指定环境，而不是每次部署改 yml 再重新打包。生产环境的数据源密码不要明文提交到 Git，用环境变量引用。

# application-prod.yml spring: datasource: username: ${DB_USERNAME} password: ${DB_PASSWORD}

java -jar register-system.jar --spring.profiles.active=prod --server.port=8080

${DB_USERNAME} 和 ${DB_PASSWORD} 会从操作系统环境变量读取，这样服务器管理员可以单独控制 Secret 的可见范围，代码仓库里不会出现数据库口令。这里注意，Windows 的 CMD 和 Linux 的 systemd 对环境变量的写法略有不同，部署文档里要写清各自设置变量的方式。

5.2 外置配置文件的加载优先级

生产环境建议把 application-prod.yml 外置到 jar 包同级目录的 config/ 下面。SpringBoot 的配置加载顺序是外部 config/ 优先于 jar 包内部文件，这样数据库地址、端口、日志路径调整时不用重新编译打包。

/app/register/ ├── register-system.jar └── config/ └── application-prod.yml

日志输出路径也要显式指定。yml 里的 logging.file.path 配成绝对路径，否则 systemd 服务的工作目录一变，日志文件就会分散到不同位置，排障时找不到历史日志。

5.3 打包命令与启动脚本要点

Maven 打包时先跑测试会导致部署被无关单元测试阻塞。我一般用跳过测试的打包命令：

mvn clean package -DskipTests

产出物在 target/register-system.jar。启动脚本里额外加上 JVM 参数：

java -Xms512m -Xmx1024m -XX:+HeapDumpOnOutOfMemoryError \ -jar /app/register/register-system.jar \ --spring.profiles.active=prod

-Xms 和 -Xmx 设置相等的值可以避免运行期堆反复扩容。HeapDumpOnOutOfMemoryError 会在内存溢出时导出 dump 文件，现场出问题后可以直接用 MAT 分析对象引用链，对定位内存泄漏帮助很大。如果服务器内存只有 2G，堆上限设 1G 比较稳妥，给系统预留出操作系统和 MySQL 的余量。

5.4 建表脚本的执行策略

SpringBoot 项目里可以用 spring.sql.init 配置自动执行建表脚本，但我不建议把 DDL 交给应用启动流程托管。更稳妥的方案是单独维护一个 sql 目录，用 Flyway 做版本化迁移。新生报到系统的表结构在开学前一个月基本冻结，用 Flyway 的好处是每台服务器执行顺序一致，字段变更记录可追溯。

spring: flyway: enabled: true locations: classpath:db/migration baseline-on-migrate: true

baseline-on-migrate 允许在已有数据库上首次执行 Flyway 时跳过版本校验，只应用后续新增的迁移脚本。V1__init_schema.sql、V2__add_register_step.sql 这种命名方式让 DBA 能直观看出脚本执行顺序。如果不用 Flyway，至少也要在发布文档里写明"先执行 SQL 再启动应用"，反过来操作经常导致启动时字段缺失报错。

6. 现场并发的兜底设计与上线验收技巧

6.1 用唯一索引解决床位并发分配

报到当天最容易出问题的接口是床位分配。两台电脑同时给同一张床分配新生时，应用层的先查后改代码会出现竞争，两个请求都查到床位为空，然后都更新成功，数据就错了。最终防线是直接在 dorm_bed 表上建唯一索引，让数据库拒绝重复分配：

ALTER TABLE dorm_bed ADD UNIQUE INDEX uk_bed_student (student_id); ALTER TABLE dorm_bed ADD UNIQUE INDEX uk_bed_no (bed_no);

student_id 维度的唯一索引保证一个学生只能占一张床，bed_no 维度的唯一索引保证一张床只能被一个学生占用。配合 UPDATE dorm_bed SET student_id = ? WHERE id = ? AND student_id IS NULL 这样的条件更新，update 影响行数为 0 就说明床位已被抢走，业务层直接返回友好提示。这种方式比分布式锁简单，也比应用层 synchronized 可靠，数据库行锁会把并发请求排队处理。

6.2 上线前的 explain 验证

每次调整索引后，用 EXPLAIN 确认查询真的走了索引：

EXPLAIN SELECT student_no, name FROM student WHERE enroll_year = 2025 AND register_status = 0;

结果里 type 为 ref 或 range、key 列有实际索引名，说明命中索引；type 为 ALL 则是全表扫描。复合索引 idx_status (register_status, enroll_year) 的最左前缀原则下，如果条件里改成只查 enroll_year，这个索引不会被使用，需要单独评估是否补一个单列索引。

6.3 缓存的取舍原则

现场高峰通常集中在上午两三个小时，一个万人生源的学校，峰值 TPS 也就每秒几十到一百，单机 SpringBoot 加 MySQL 完全能扛住。不要一开始就引入 Redis 缓存、分布式锁这些复杂方案。先把数据库索引和事务边界做对，用 JMeter 或 wrk 压出接口的瓶颈 TPS，真遇到读多写少的场景（比如专业列表、宿舍楼列表），再用 Caffeine 做本地缓存，缓存失效时间设 5 到 10 分钟就够。新生报到系统不是一个长期高并发的业务，过度设计会让维护成本超过它的收益。

本文还有配套的精品资源，点击获取