简介一套基于Spring Boot的招生与就业信息管理系统源码包面向高校教务管理人员、Java后端开发者及毕业设计学生用于实现招生申请处理、资格审核与毕业生就业服务的全流程数字化管理。资源共1806个文件压缩包大小69.97MB包含370个png、328个gif等界面素材222个js、158个css与144个ftl模板共同支撑前端页面展示207个class与200个java文件构成后端业务逻辑另附SQL数据库脚本、Excel导出工具、Maven配置等导入开发环境即可阅读调试。系统覆盖在线申请、招生计划管理、职位发布、简历投递、招聘会管理、就业跟踪等典型功能模块内容预览中的ExamineeController、ExportExcelUtil、ScheduleJobServiceImpl等类可帮助理解招生业务实现、数据导出及定时调度等常见场景的设计思路。目前已有566人学习下载适合作为Spring Boot项目实战、课程设计参考及高校信息化系统二次开发的实用基础。1. 招生与就业信息管理系统招生就业双线数据Spring Boot 撑得起吗做招生就业管理的老师最怕什么不是学生难管而是两个系统数据对不上招生处登记的考生号到了就业处变成了学号这边统计录取率那边统计就业率两个数字口径不一年底汇报时还得手工拼表。我拆过一套基于 Spring Boot 的招生与就业信息管理系统绑定「招生」与「就业」两条业务线用同一套数据底座完成从生源报名、录取审核、学籍迁移到就业信息填报、去向审核、就业率统计的全流程。它不炫技但把关键业务场景都覆盖了尤其适合中小规模院校或培训机构使用。新手用它学 Spring Boot 全栈开发很合适熟手可以拿来当二次开发的底子。这系统用的技术栈就是标题里的 spirngboot 生态Spring Boot MyBatis Plus MySQL外加 EasyExcel 做批量导入导出。下面从拆解到落地我把真实踩过的坑一并说清楚。2. 系统拆解Spring Boot MyBatis Plus MySQL选型逻辑先说清楚2.1 业务模块边界招生、就业、统计三块怎么切分拿到需求时最忌讳一上来就建表。招生就业这个场景有天然的时间线招生阶段关注考生信息、报考志愿、录取状态入校后学生信息转入学籍毕业阶段关注就业去向、单位信息。三个阶段的共同主体是「学生」但字段差异很大。所以模块切分我建议按业务阶段分而不是按角色分。招生管理生源报名表、招生计划、专业设置、录取审核、通知书发放就业管理毕业生信息、就业去向填报、单位库、就业审核、派遣管理统计看板按专业、按地区的录取率、报到率、就业率统计这套系统的做法是把「学生基础信息表」作为主表招生阶段用candidate_id标识毕业阶段用student_id标识两者通过batch_year和id_card关联。这样三个模块在数据库层面共用一个主表业务逻辑各自独立职责不混淆。2.2 数据模型设计主表、关联表与冗余字段的取舍我见过不少学员把招生、就业做成两张完全独立的表结果统计时 join 得头秃。更合理的方案是一张student主表保存姓名、身份证号、性别、生源地区、入学年份招生扩展表admission_info保存考生号、志愿专业、面试成绩、录取状态就业扩展表employment_info保存学号、毕业年份、就业状态、单位名称、岗位类别。三张表通过student_id关联。主表与扩展表的设计能避免字段冗余但有一个代价查询时需要多次 join。在数据量可控几万行的规模下这完全不是问题。反而是过度冗余会把状态搞乱。比如「录取状态」和「就业状态」如果放在主表不同阶段的人都会改这个字段权限控制成了纸糊的。所以我一般会建议主表只放不变的基础属性可变状态全部下沉到扩展表。这样每个模块只管自己的状态位互不干扰。2.3 工程结构Maven 单模块还是多模块网上很多教程推崇多模块划分但实际做这个项目单模块足够。多模块适合多个团队并行开发或者是基础框架和业务需要独立发版。这里无非是 admin 端和 api 端一起部署单模块 Maven 工程配合包名分包完全够用。我习惯的包结构是com.example.admission ├── common # 统一返回、异常处理、工具类 ├── config # 跨域配置、MyBatis Plus 配置 ├── controller # 招生、就业、统计各模块的接口 ├── service # 业务逻辑 ├── mapper # MyBatis Plus 的 Mapper 接口 ├── entity # 数据库实体 ├── dto # 接受前端参数的模型 └── vo # 返回给前端的模型对应的pom.xml关键依赖如下dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.2/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency dependency groupIdcom.alibaba/groupId artifactIdeasyexcel/artifactId version3.3.2/version /dependency这里有几个参数需要说明。mybatis-plus-boot-starter我用 3.5.3.2 版本对应 Spring Boot 2.7 稳定如果你用的是 Spring Boot 3.x需要换mybatis-plus-spring-boot3-starter。EasyExcel 3.3.2 是目前比较稳定的版本低版本对LocalDateTime的转换有坑后面会细说。单模块的缺点是启动稍慢、代码都揉在一起但换来的好处是调试方便本地一个Application类就能启动全部功能。作为交付型项目我更推荐这种。3. 招生模块实战从生源登记到录取审核的完整链路3.1 生源导入的 Excel 解析与批量写入的坑招生季最痛的是整理报考名单。系统提供的功能是从 Excel 模板导入生源。我用 EasyExcel 写了导入逻辑关键代码如下public BaseResponseString importCandidates(MultipartFile file) { // 读取 Excel逐行映射到 CandidateImportDTO ListCandidateImportDTO list new ArrayList(); try { EasyExcel.read(file.getInputStream()) .head(CandidateImportDTO.class) .registerReadListener(new AnalysisEventListenerCandidateImportDTO() { Override public void invoke(CandidateImportDTO dto, AnalysisContext context) { // 这里可以做行级校验身份证号格式、必填项检查 list.add(dto); } Override public void doAfterAllAnalysed(AnalysisContext context) { // 读取完成后批量写入见下面方法 } }).sheet().doRead(); } catch (IOException e) { return BaseResponse.error(文件解析失败 e.getMessage()); } return BaseResponse.success(batchInsertCandidates(list)); }批量写入我直接用了 MyBatis Plus 的saveBatch默认 batchSize 是 1000。但这里有个实验课上容易翻车如果一次性导入上万行saveBatch默认会拼一条超大 SQL可能导致 MySQL 的max_allowed_packet超限。解决办法是分批// 每500条一批避免SQL过大 for (int i 0; i list.size(); i 500) { ListCandidateImportDTO subList list.subList(i, Math.min(i 500, list.size())); candidateService.saveBatch(subList); }参数batchSize1000是 MyBatis Plus 的默认值对于个体段字段多的表行数据长容易出现包超限。我一般压到 500。这个数字不是玄学是max_allowed_packet64M时500 行 20 个字段每行 1KB 左右大约 10MB安全。3.2 录取审核状态机用 status 字段还是用设计模式录取审核流程一般是待审核 - 初审通过 - 复审通过 - 录取任意环节都可以退回。很多新手用一个status字段加上一堆 if-else 做状态流转结果过几天业务方说要加一个「补材料」状态代码全得改。在这个项目里我用的是状态机表加简单的策略判断没有引入沉重的状态机框架。状态表里定义CREATE TABLE admission_status_log ( id BIGINT PRIMARY KEY AUTO_INCREMENT, candidate_id BIGINT NOT NULL, from_status VARCHAR(20), to_status VARCHAR(20), operator_id BIGINT, remark VARCHAR(255), create_time DATETIME );代码层用switch判断当前状态允许的下一步操作比如public boolean checkTransition(String current, String target) { switch (current) { case PENDING: return ADMITTED.equals(target) || REJECTED.equals(target); case ADMITTED: return ENROLLED.equals(target) || REJECTED.equals(target); default: return false; } }这个写法的好处是状态流转规则集中在一个方法里后续新增状态只改这个switch。配合状态日志表每次状态变更都记一条流水出问题能回溯。你一定别把状态字段放到student主表否则日志就变成摆设了。3.3 面试安排与短信通知的接口设计招生环节常需要安排线上面试。系统里我设计了interview表包含时间段、面试官、会议链接。面试前两天要发短信通知短信服务用的是阿里云 SMS 的 SDK核心代码public void sendInterviewNotice(Long candidateId) { Candidate candidate candidateService.getById(candidateId); Interview interview interviewService.getByCandidateId(candidateId); String templateParam String.format({\name\:\%s\,\time\:\%s\}, candidate.getName(), interview.getStartTime().toString()); SendSmsRequest request new SendSmsRequest(); request.setPhoneNumbers(candidate.getPhone()); request.setTemplateCode(SMS_123456); request.setTemplateParam(templateParam); // TODO: 填充 AccessKey 等认证信息 SendSmsResponse response smsClient.sendSms(request); if (response.getCode() ! null OK.equals(response.getCode())) { interviewService.markNotified(candidateId); } }这里的参数说明templateParam的 JSON 字符串必须转义很多同学直接拼字符串导致短信内容里出现{name:xxx}而不是实际的姓名。另外所有发送记录建议落表避免短信服务商回调丢失时无法确认。我一般会加一个sms_send_log表把请求和响应都存起来方便排查「为什么没收到短信」。4. 就业模块与统计报表从数据录入到可视化4.1 就业信息管理与学籍表的多表联查就业模块的核心是毕业生填写去向管理员审核后归入统计。学生端提交的employment_info表包含单位名称、统一社会信用代码、岗位、薪资、是否派遣。管理员端查看时需要 join 学生主表拿到姓名和专业。MyBatis Plus 的多表联查不能用内置的selectById我习惯在 Mapper 里写自定义 SQLSelect(SELECT e.id, s.name, s.major, e.company_name, e.position, e.salary, e.status FROM employment_info e LEFT JOIN student s ON e.student_id s.id WHERE e.graduate_year #{year} ORDER BY e.create_time DESC) ListEmploymentVO queryEmploymentByYear(Param(year) Integer year);注意LEFT JOIN的目的是保留未填写就业信息的学生记录让管理员看到「未填报」的空缺行。如果使用 INNER JOIN未填报的学生直接不显示统计人数就会偏少。这个细节在汇报时很致命。4.2 就业率统计SQL 还是 Java8 stream统计口径一般有三种已就业 / 未就业 / 升学的占比。SQL 直接聚合是更高效的方式SELECT SUM(CASE WHEN status EMPLOYED THEN 1 ELSE 0 END) AS employed_cnt, SUM(CASE WHEN status CONTINUE_STUDY THEN 1 ELSE 0 END) AS study_cnt, COUNT(*) AS total_cnt FROM employment_info WHERE graduate_year 2024 AND deleted 0;但是如果统计需要按专业分组、再算比例用 Java 8 stream 过滤排序反而更直观因为代码可读性比长 SQL 好。我在系统里两者结合聚合统计走 SQL明细过滤走 stream。比如前端要展示「每个专业的就业率柱状图」我会先查出行明细再在内存分组MapString, Long countByStatus employmentList.stream() .collect(Collectors.groupingBy( e - String.format(%s-%s, e.getMajor(), e.getStatus()), Collectors.counting() ));这个做法在数据量 5 万以下完全够用还能减轻 MySQL group by 的临时表压力。但你要记住如果数据上百万stream 分组会撑爆内存那时必须回到 SQL 的group by。4.3 报表导出EasyExcel 模板填充实战管理员经常要导出「就业率月报表」给上级看。我用 EasyExcel 的模板填充功能先在 resources 下放一个 Excel 模板里面用{.字段名}占位然后代码填充public void exportReport(HttpServletResponse response) throws IOException { // 模拟统计数据 MapString, Object data new HashMap(); data.put(year, 2024); data.put(total, 3200); data.put(employed, 2800); data.put(rate, 87.5%); String templatePath classpath:/templates/employment_report_template.xlsx; ExcelWriter writer EasyExcel.write(response.getOutputStream()) .withTemplate(templatePath) .build(); WriteSheet sheet EasyExcel.writerSheet().build(); writer.fill(data, sheet); writer.finish(); }这里必须提醒一个很大的坑EasyExcel 的模板填充要求占位符必须写在单元格中不能是合并单元格跨越多个位置否则会填不进去。我在第一次开发时把「年份」放在合并单元格里执行完发现所有数据都挤在第一个单元格页面直接花掉。解决办法是把模板拆散不要让占位符出现在合并区域中。5. 避坑指南Spring Boot 项目从开发到部署的四个经典翻车点5.1 时区问题日期写入数据库少了 8 小时现象前端选面试时间是2024-06-01 10:00保存到 MySQL 后变成2024-05-31 18:00第二天面试官按数据库时间上线差点错过。原因MySQL 连接串没指定serverTimezone默认用了服务器时区而本地应用是东八区。JDBC 驱动把本地时间翻译成 UTC 再写入就少了 8 小时。解决在application.yml的 JDBC URL 显式加上时区参数url: jdbc:mysql://localhost:3306/admission?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai同时实体类里的时间字段统一用LocalDateTime不要用java.util.Date。LocalDateTime不带时区配合 JDBC 8.0 驱动和显式时区设置基本不会出偏差。从那以后我每次新建项目的第一件事就是检查连接串时区没有例外。5.2 批量插入太慢MyBatis Plus 的分批参数没设置现象导入 1 万条生源数据saveBatch执行了 6 秒多而且中间有一次报PacketTooBigException。原因MyBatis Plus 的saveBatch默认batchSize1000但它是通过拼接多条 VALUES 语句实现的不是真正的 JDBC batch。单条数据字段长时拼接 SQL 非常容易超出 MySQL 包大小限制。解决按照第 3.1 节那样手动切分每批 500 条。另外可以在 JDBC URL 增加 rewriteBatchedStatementstrue让驱动执行真正的批量插入url: jdbc:mysql://localhost:3306/admission?rewriteBatchedStatementstrue开启这个参数后MyBatis Plus 内部执行批量时会采用addBatch方式插入性能提升非常明显。实测 1 万条从 6 秒降到 1.5 秒左右。注意这个参数不适用于所有场景如果有大量普通的 insert 单条执行不会有副作用。5.3 文件上传大小默认 1MB招生照片全被拒现象管理员上传学生证件照超过 1MB 就报MaxUploadSizeExceededException前端直接红屏。原因Spring Boot 内置的spring.servlet.multipart.max-file-size默认是 1MB只适合小图片。招生系统里的证件照来自手机拍摄动不动 3-5MB。解决在配置里调大上传限制同时设置单次请求总大小spring: servlet: multipart: max-file-size: 10MB max-request-size: 20MB这里我还顺手做了一个文件校验不能只靠 Spring 的报错。因为在 Nginx 反向代理层也有client_max_body_size不调大 Nginx 也很容易看到 413 错误。建议前后端约定上传前先做客户端压缩减少服务器压力。很多初学者只改了 Spring 配置忽略了 Nginx导致本地正常部署后翻车。5.4 跨域配置失效前端连不上后端的排查思路现象本地前端访问 8080 接口浏览器报 CORS 错误明明写了跨域配置却无效。原因Spring Boot 中如果同时使用了拦截器或者自定义WebMvcConfigurer而跨域配置写错位置会被其他配置覆盖。特别是当你使用了CrossOrigin注解或CorsFilter与时优先级和路径匹配规则可能互相冲突。解决我的统一做法是使用CorsFilter并且放在FilterRegistrationBean中设置最高优先级Bean public CorsFilter corsFilter() { UrlBasedCorsConfigurationSource source new UrlBasedCorsConfigurationSource(); CorsConfiguration config new CorsConfiguration(); config.setAllowCredentials(true); config.setAllowedOriginPatterns(List.of(*)); config.addAllowedHeader(*); config.addAllowedMethod(*); source.registerCorsConfiguration(/**, config); return new CorsFilter(source); }注意setAllowedOriginPatterns(*)不能与setAllowCredentials(true)同时使用旧版的setAllowedOrigins必须用 OriginPatterns。如果配置后仍然报错去看是否有OncePerRequestFilter之类提前写入了响应头。跨域问题排查顺序应该是先确认请求确实到达后端再用浏览器直接 curl 加 Origin 头测试最后才考虑改代码。6. 最后一公里统计接口的单元测试与部署前检查清单系统上线前我给统计接口写了几个轻量级的集成测试不用 Mockito 全套而是用SpringBootTest真实连一次本地数据库验证 SQL 聚合逻辑和返回值结构。举一个就业率接口的测试片段SpringBootTest class StatisticsServiceTest { Autowired private StatisticsService statisticsService; Test void testEmploymentRate() { // 准备测试数据插入已知状态的两条记录 EmploymentRateVO vo statisticsService.getEmploymentRate(2024); assertNotNull(vo); assertTrue(vo.getTotal() 0); // 断言百分比在合理区间 Assert.isTrue(vo.getRate() 0 vo.getRate() 100, rate out of range); } }这个测试的价值不是测业务逻辑而是保证统计 SQL 在 Spring 容器里能跑通防止别人改了表结构导致字段映射错位。每次要部署前我习惯跑一遍所有测试确认基础数据没问题才打包。另外给部署的人一份自查清单我通常放在项目 README 的最后检查项预期结果排查手段数据库连接启动日志无Access deniedmysql -u root -p手动连接时区配置写入时间与本地一致插入一条记录看时间戳文件上传5MB 照片可正常上传用 curl 模拟 multipart 请求跨域访问前端正常调接口浏览器 F12 看网络响应头定时任务就业率月报自动生成查schedule_log表这套检查清单不是一次性用的每次版本迭代都要走一遍。尤其是体检时区那条改动数据库配置最容易复发。还有一次我把serverTimezone写成了UTC结果测试全通过但报表日期全乱从那以后我每次部署前都强制把「插入一条带时间的数据」这个动作加进检查流程再也没翻过车。招生就业系统这类项目的核心价值在于把重复劳动自动化而 Spring Boot 的生态足够成熟踩坑也有迹可循。希望这篇文章能帮你在自己的项目里少走几步弯路顺利把系统跑起来。本文还有配套的精品资源点击获取 
长河君 · 2026/10/10 12:36:17 · 阅读 1.2k Spring Boot招生就业管理系统实战：数据模型、批量导入与部署避坑
简介一套基于Spring Boot的招生与就业信息管理系统源码包面向高校教务管理人员、Java后端开发者及毕业设计学生用于实现招生申请处理、资格审核与毕业生就业服务的全流程数字化管理。资源共1806个文件压缩包大小69.97MB包含370个png、328个gif等界面素材222个js、158个css与144个ftl模板共同支撑前端页面展示207个class与200个java文件构成后端业务逻辑另附SQL数据库脚本、Excel导出工具、Maven配置等导入开发环境即可阅读调试。系统覆盖在线申请、招生计划管理、职位发布、简历投递、招聘会管理、就业跟踪等典型功能模块内容预览中的ExamineeController、ExportExcelUtil、ScheduleJobServiceImpl等类可帮助理解招生业务实现、数据导出及定时调度等常见场景的设计思路。目前已有566人学习下载适合作为Spring Boot项目实战、课程设计参考及高校信息化系统二次开发的实用基础。1. 招生与就业信息管理系统招生就业双线数据Spring Boot 撑得起吗做招生就业管理的老师最怕什么不是学生难管而是两个系统数据对不上招生处登记的考生号到了就业处变成了学号这边统计录取率那边统计就业率两个数字口径不一年底汇报时还得手工拼表。我拆过一套基于 Spring Boot 的招生与就业信息管理系统绑定「招生」与「就业」两条业务线用同一套数据底座完成从生源报名、录取审核、学籍迁移到就业信息填报、去向审核、就业率统计的全流程。它不炫技但把关键业务场景都覆盖了尤其适合中小规模院校或培训机构使用。新手用它学 Spring Boot 全栈开发很合适熟手可以拿来当二次开发的底子。这系统用的技术栈就是标题里的 spirngboot 生态Spring Boot MyBatis Plus MySQL外加 EasyExcel 做批量导入导出。下面从拆解到落地我把真实踩过的坑一并说清楚。2. 系统拆解Spring Boot MyBatis Plus MySQL选型逻辑先说清楚2.1 业务模块边界招生、就业、统计三块怎么切分拿到需求时最忌讳一上来就建表。招生就业这个场景有天然的时间线招生阶段关注考生信息、报考志愿、录取状态入校后学生信息转入学籍毕业阶段关注就业去向、单位信息。三个阶段的共同主体是「学生」但字段差异很大。所以模块切分我建议按业务阶段分而不是按角色分。招生管理生源报名表、招生计划、专业设置、录取审核、通知书发放就业管理毕业生信息、就业去向填报、单位库、就业审核、派遣管理统计看板按专业、按地区的录取率、报到率、就业率统计这套系统的做法是把「学生基础信息表」作为主表招生阶段用candidate_id标识毕业阶段用student_id标识两者通过batch_year和id_card关联。这样三个模块在数据库层面共用一个主表业务逻辑各自独立职责不混淆。2.2 数据模型设计主表、关联表与冗余字段的取舍我见过不少学员把招生、就业做成两张完全独立的表结果统计时 join 得头秃。更合理的方案是一张student主表保存姓名、身份证号、性别、生源地区、入学年份招生扩展表admission_info保存考生号、志愿专业、面试成绩、录取状态就业扩展表employment_info保存学号、毕业年份、就业状态、单位名称、岗位类别。三张表通过student_id关联。主表与扩展表的设计能避免字段冗余但有一个代价查询时需要多次 join。在数据量可控几万行的规模下这完全不是问题。反而是过度冗余会把状态搞乱。比如「录取状态」和「就业状态」如果放在主表不同阶段的人都会改这个字段权限控制成了纸糊的。所以我一般会建议主表只放不变的基础属性可变状态全部下沉到扩展表。这样每个模块只管自己的状态位互不干扰。2.3 工程结构Maven 单模块还是多模块网上很多教程推崇多模块划分但实际做这个项目单模块足够。多模块适合多个团队并行开发或者是基础框架和业务需要独立发版。这里无非是 admin 端和 api 端一起部署单模块 Maven 工程配合包名分包完全够用。我习惯的包结构是com.example.admission ├── common # 统一返回、异常处理、工具类 ├── config # 跨域配置、MyBatis Plus 配置 ├── controller # 招生、就业、统计各模块的接口 ├── service # 业务逻辑 ├── mapper # MyBatis Plus 的 Mapper 接口 ├── entity # 数据库实体 ├── dto # 接受前端参数的模型 └── vo # 返回给前端的模型对应的pom.xml关键依赖如下dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.2/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency dependency groupIdcom.alibaba/groupId artifactIdeasyexcel/artifactId version3.3.2/version /dependency这里有几个参数需要说明。mybatis-plus-boot-starter我用 3.5.3.2 版本对应 Spring Boot 2.7 稳定如果你用的是 Spring Boot 3.x需要换mybatis-plus-spring-boot3-starter。EasyExcel 3.3.2 是目前比较稳定的版本低版本对LocalDateTime的转换有坑后面会细说。单模块的缺点是启动稍慢、代码都揉在一起但换来的好处是调试方便本地一个Application类就能启动全部功能。作为交付型项目我更推荐这种。3. 招生模块实战从生源登记到录取审核的完整链路3.1 生源导入的 Excel 解析与批量写入的坑招生季最痛的是整理报考名单。系统提供的功能是从 Excel 模板导入生源。我用 EasyExcel 写了导入逻辑关键代码如下public BaseResponseString importCandidates(MultipartFile file) { // 读取 Excel逐行映射到 CandidateImportDTO ListCandidateImportDTO list new ArrayList(); try { EasyExcel.read(file.getInputStream()) .head(CandidateImportDTO.class) .registerReadListener(new AnalysisEventListenerCandidateImportDTO() { Override public void invoke(CandidateImportDTO dto, AnalysisContext context) { // 这里可以做行级校验身份证号格式、必填项检查 list.add(dto); } Override public void doAfterAllAnalysed(AnalysisContext context) { // 读取完成后批量写入见下面方法 } }).sheet().doRead(); } catch (IOException e) { return BaseResponse.error(文件解析失败 e.getMessage()); } return BaseResponse.success(batchInsertCandidates(list)); }批量写入我直接用了 MyBatis Plus 的saveBatch默认 batchSize 是 1000。但这里有个实验课上容易翻车如果一次性导入上万行saveBatch默认会拼一条超大 SQL可能导致 MySQL 的max_allowed_packet超限。解决办法是分批// 每500条一批避免SQL过大 for (int i 0; i list.size(); i 500) { ListCandidateImportDTO subList list.subList(i, Math.min(i 500, list.size())); candidateService.saveBatch(subList); }参数batchSize1000是 MyBatis Plus 的默认值对于个体段字段多的表行数据长容易出现包超限。我一般压到 500。这个数字不是玄学是max_allowed_packet64M时500 行 20 个字段每行 1KB 左右大约 10MB安全。3.2 录取审核状态机用 status 字段还是用设计模式录取审核流程一般是待审核 - 初审通过 - 复审通过 - 录取任意环节都可以退回。很多新手用一个status字段加上一堆 if-else 做状态流转结果过几天业务方说要加一个「补材料」状态代码全得改。在这个项目里我用的是状态机表加简单的策略判断没有引入沉重的状态机框架。状态表里定义CREATE TABLE admission_status_log ( id BIGINT PRIMARY KEY AUTO_INCREMENT, candidate_id BIGINT NOT NULL, from_status VARCHAR(20), to_status VARCHAR(20), operator_id BIGINT, remark VARCHAR(255), create_time DATETIME );代码层用switch判断当前状态允许的下一步操作比如public boolean checkTransition(String current, String target) { switch (current) { case PENDING: return ADMITTED.equals(target) || REJECTED.equals(target); case ADMITTED: return ENROLLED.equals(target) || REJECTED.equals(target); default: return false; } }这个写法的好处是状态流转规则集中在一个方法里后续新增状态只改这个switch。配合状态日志表每次状态变更都记一条流水出问题能回溯。你一定别把状态字段放到student主表否则日志就变成摆设了。3.3 面试安排与短信通知的接口设计招生环节常需要安排线上面试。系统里我设计了interview表包含时间段、面试官、会议链接。面试前两天要发短信通知短信服务用的是阿里云 SMS 的 SDK核心代码public void sendInterviewNotice(Long candidateId) { Candidate candidate candidateService.getById(candidateId); Interview interview interviewService.getByCandidateId(candidateId); String templateParam String.format({\name\:\%s\,\time\:\%s\}, candidate.getName(), interview.getStartTime().toString()); SendSmsRequest request new SendSmsRequest(); request.setPhoneNumbers(candidate.getPhone()); request.setTemplateCode(SMS_123456); request.setTemplateParam(templateParam); // TODO: 填充 AccessKey 等认证信息 SendSmsResponse response smsClient.sendSms(request); if (response.getCode() ! null OK.equals(response.getCode())) { interviewService.markNotified(candidateId); } }这里的参数说明templateParam的 JSON 字符串必须转义很多同学直接拼字符串导致短信内容里出现{name:xxx}而不是实际的姓名。另外所有发送记录建议落表避免短信服务商回调丢失时无法确认。我一般会加一个sms_send_log表把请求和响应都存起来方便排查「为什么没收到短信」。4. 就业模块与统计报表从数据录入到可视化4.1 就业信息管理与学籍表的多表联查就业模块的核心是毕业生填写去向管理员审核后归入统计。学生端提交的employment_info表包含单位名称、统一社会信用代码、岗位、薪资、是否派遣。管理员端查看时需要 join 学生主表拿到姓名和专业。MyBatis Plus 的多表联查不能用内置的selectById我习惯在 Mapper 里写自定义 SQLSelect(SELECT e.id, s.name, s.major, e.company_name, e.position, e.salary, e.status FROM employment_info e LEFT JOIN student s ON e.student_id s.id WHERE e.graduate_year #{year} ORDER BY e.create_time DESC) ListEmploymentVO queryEmploymentByYear(Param(year) Integer year);注意LEFT JOIN的目的是保留未填写就业信息的学生记录让管理员看到「未填报」的空缺行。如果使用 INNER JOIN未填报的学生直接不显示统计人数就会偏少。这个细节在汇报时很致命。4.2 就业率统计SQL 还是 Java8 stream统计口径一般有三种已就业 / 未就业 / 升学的占比。SQL 直接聚合是更高效的方式SELECT SUM(CASE WHEN status EMPLOYED THEN 1 ELSE 0 END) AS employed_cnt, SUM(CASE WHEN status CONTINUE_STUDY THEN 1 ELSE 0 END) AS study_cnt, COUNT(*) AS total_cnt FROM employment_info WHERE graduate_year 2024 AND deleted 0;但是如果统计需要按专业分组、再算比例用 Java 8 stream 过滤排序反而更直观因为代码可读性比长 SQL 好。我在系统里两者结合聚合统计走 SQL明细过滤走 stream。比如前端要展示「每个专业的就业率柱状图」我会先查出行明细再在内存分组MapString, Long countByStatus employmentList.stream() .collect(Collectors.groupingBy( e - String.format(%s-%s, e.getMajor(), e.getStatus()), Collectors.counting() ));这个做法在数据量 5 万以下完全够用还能减轻 MySQL group by 的临时表压力。但你要记住如果数据上百万stream 分组会撑爆内存那时必须回到 SQL 的group by。4.3 报表导出EasyExcel 模板填充实战管理员经常要导出「就业率月报表」给上级看。我用 EasyExcel 的模板填充功能先在 resources 下放一个 Excel 模板里面用{.字段名}占位然后代码填充public void exportReport(HttpServletResponse response) throws IOException { // 模拟统计数据 MapString, Object data new HashMap(); data.put(year, 2024); data.put(total, 3200); data.put(employed, 2800); data.put(rate, 87.5%); String templatePath classpath:/templates/employment_report_template.xlsx; ExcelWriter writer EasyExcel.write(response.getOutputStream()) .withTemplate(templatePath) .build(); WriteSheet sheet EasyExcel.writerSheet().build(); writer.fill(data, sheet); writer.finish(); }这里必须提醒一个很大的坑EasyExcel 的模板填充要求占位符必须写在单元格中不能是合并单元格跨越多个位置否则会填不进去。我在第一次开发时把「年份」放在合并单元格里执行完发现所有数据都挤在第一个单元格页面直接花掉。解决办法是把模板拆散不要让占位符出现在合并区域中。5. 避坑指南Spring Boot 项目从开发到部署的四个经典翻车点5.1 时区问题日期写入数据库少了 8 小时现象前端选面试时间是2024-06-01 10:00保存到 MySQL 后变成2024-05-31 18:00第二天面试官按数据库时间上线差点错过。原因MySQL 连接串没指定serverTimezone默认用了服务器时区而本地应用是东八区。JDBC 驱动把本地时间翻译成 UTC 再写入就少了 8 小时。解决在application.yml的 JDBC URL 显式加上时区参数url: jdbc:mysql://localhost:3306/admission?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai同时实体类里的时间字段统一用LocalDateTime不要用java.util.Date。LocalDateTime不带时区配合 JDBC 8.0 驱动和显式时区设置基本不会出偏差。从那以后我每次新建项目的第一件事就是检查连接串时区没有例外。5.2 批量插入太慢MyBatis Plus 的分批参数没设置现象导入 1 万条生源数据saveBatch执行了 6 秒多而且中间有一次报PacketTooBigException。原因MyBatis Plus 的saveBatch默认batchSize1000但它是通过拼接多条 VALUES 语句实现的不是真正的 JDBC batch。单条数据字段长时拼接 SQL 非常容易超出 MySQL 包大小限制。解决按照第 3.1 节那样手动切分每批 500 条。另外可以在 JDBC URL 增加 rewriteBatchedStatementstrue让驱动执行真正的批量插入url: jdbc:mysql://localhost:3306/admission?rewriteBatchedStatementstrue开启这个参数后MyBatis Plus 内部执行批量时会采用addBatch方式插入性能提升非常明显。实测 1 万条从 6 秒降到 1.5 秒左右。注意这个参数不适用于所有场景如果有大量普通的 insert 单条执行不会有副作用。5.3 文件上传大小默认 1MB招生照片全被拒现象管理员上传学生证件照超过 1MB 就报MaxUploadSizeExceededException前端直接红屏。原因Spring Boot 内置的spring.servlet.multipart.max-file-size默认是 1MB只适合小图片。招生系统里的证件照来自手机拍摄动不动 3-5MB。解决在配置里调大上传限制同时设置单次请求总大小spring: servlet: multipart: max-file-size: 10MB max-request-size: 20MB这里我还顺手做了一个文件校验不能只靠 Spring 的报错。因为在 Nginx 反向代理层也有client_max_body_size不调大 Nginx 也很容易看到 413 错误。建议前后端约定上传前先做客户端压缩减少服务器压力。很多初学者只改了 Spring 配置忽略了 Nginx导致本地正常部署后翻车。5.4 跨域配置失效前端连不上后端的排查思路现象本地前端访问 8080 接口浏览器报 CORS 错误明明写了跨域配置却无效。原因Spring Boot 中如果同时使用了拦截器或者自定义WebMvcConfigurer而跨域配置写错位置会被其他配置覆盖。特别是当你使用了CrossOrigin注解或CorsFilter与时优先级和路径匹配规则可能互相冲突。解决我的统一做法是使用CorsFilter并且放在FilterRegistrationBean中设置最高优先级Bean public CorsFilter corsFilter() { UrlBasedCorsConfigurationSource source new UrlBasedCorsConfigurationSource(); CorsConfiguration config new CorsConfiguration(); config.setAllowCredentials(true); config.setAllowedOriginPatterns(List.of(*)); config.addAllowedHeader(*); config.addAllowedMethod(*); source.registerCorsConfiguration(/**, config); return new CorsFilter(source); }注意setAllowedOriginPatterns(*)不能与setAllowCredentials(true)同时使用旧版的setAllowedOrigins必须用 OriginPatterns。如果配置后仍然报错去看是否有OncePerRequestFilter之类提前写入了响应头。跨域问题排查顺序应该是先确认请求确实到达后端再用浏览器直接 curl 加 Origin 头测试最后才考虑改代码。6. 最后一公里统计接口的单元测试与部署前检查清单系统上线前我给统计接口写了几个轻量级的集成测试不用 Mockito 全套而是用SpringBootTest真实连一次本地数据库验证 SQL 聚合逻辑和返回值结构。举一个就业率接口的测试片段SpringBootTest class StatisticsServiceTest { Autowired private StatisticsService statisticsService; Test void testEmploymentRate() { // 准备测试数据插入已知状态的两条记录 EmploymentRateVO vo statisticsService.getEmploymentRate(2024); assertNotNull(vo); assertTrue(vo.getTotal() 0); // 断言百分比在合理区间 Assert.isTrue(vo.getRate() 0 vo.getRate() 100, rate out of range); } }这个测试的价值不是测业务逻辑而是保证统计 SQL 在 Spring 容器里能跑通防止别人改了表结构导致字段映射错位。每次要部署前我习惯跑一遍所有测试确认基础数据没问题才打包。另外给部署的人一份自查清单我通常放在项目 README 的最后检查项预期结果排查手段数据库连接启动日志无Access deniedmysql -u root -p手动连接时区配置写入时间与本地一致插入一条记录看时间戳文件上传5MB 照片可正常上传用 curl 模拟 multipart 请求跨域访问前端正常调接口浏览器 F12 看网络响应头定时任务就业率月报自动生成查schedule_log表这套检查清单不是一次性用的每次版本迭代都要走一遍。尤其是体检时区那条改动数据库配置最容易复发。还有一次我把serverTimezone写成了UTC结果测试全通过但报表日期全乱从那以后我每次部署前都强制把「插入一条带时间的数据」这个动作加进检查流程再也没翻过车。招生就业系统这类项目的核心价值在于把重复劳动自动化而 Spring Boot 的生态足够成熟踩坑也有迹可循。希望这篇文章能帮你在自己的项目里少走几步弯路顺利把系统跑起来。本文还有配套的精品资源点击获取