企业官网建设流程全解析

简介：这是一份基于Java的学生档案管理系统毕业设计文档，面向计算机、软件工程等专业学生，可作为毕业设计参考或课程设计模板。文档系统梳理了从需求分析到系统实现的完整流程，包括性能需求、运行环境、B/S架构下的模型结构、Java与JSP技术选型、Tomcat部署、MySQL数据库设计，以及E-R图、主要数据表和登录、院系专业、学生信息、教师信息、课程、成绩、奖惩等管理模块的功能与核心代码分析，兼顾设计思路与实现细节。同时，文档包含摘要、目录、正文、结束语、参考文献、致谢等完整毕业设计结构，并提供了JSP编程技术和MySQL数据库开发的关键代码示例，可直接作为论文框架和系统开发的双重参考。资源共1个docx文件，压缩包约410KB，内容以文字和图表形式呈现，便于直接编辑修改。已有458人学习下载，是一份结构清晰、内容详实的学生档案管理系统设计与实现方案。

1. 学生档案管理系统到底在管什么：给没写过 Java Web 毕设的人一个全景图

以 Java 技术栈来做一个学生档案管理系统，是高校毕业设计和低年级课设里最不高调却一直高频的方向。很多同学以为“管理系统”就是对着数据库写增删改查，真正开始做才发现，老师手里的学生档案不只是名字和学号，还有班级、成绩、奖惩、宿舍、联系方式变动，甚至还有纸质材料的扫描件。这套系统要解决的，是把散落在 Excel、纸质表格和聊天记录里的学生信息收拢到一个 Web 网站里，让管理员录得进、查得着，让授课教师能按班级筛选，让学生本人只能看自己的档案。

这个标题背后其实是一款面向高校教务/学工场景的典型 Java Web 应用，适合正在选毕业设计题目的在校生，也适合刚转行、想用一套完整项目证明自己能做前后端联通的初级 Java 工程师。反直觉的结论是：这个系统 80% 的工作量不在“增删改查”本身，而在角色权限、表关系、字段边界和部署细节这些容易被忽视的地方。下面从表结构开始，把设计与实现按一条可落地的路径拆开。

2. 从需求到表结构：先想清楚再敲代码，学生档案管理系统的核心设计

2.1 角色与功能边界：别把系统做成一个无限收纳箱

做设计前先问自己三个问题：谁在用？管什么？管到什么粒度？我见过最常翻车的做法，是打开建表工具一口气设计二十几张表，把军训报名、社团活动都塞进来，结果写到一半连自己都理不清外键关系。

学生档案管理系统最常见的角色有三种：管理员、教师、学生。管理员负责维护班级和学生基础信息，批量导入数据，管理账号和操作日志；教师可以按班级或课程范围查询学生档案，导出成绩单；学生只允许查看自己的档案和部分成绩，不能改任何核心字段。功能边界一旦划清楚，权限控制就落在“角色 - 菜单 - 接口”三张关联表上，不需要在业务代码里到处写 if 判断。

管的粒度也要收敛。一个最小可用系统建议从五类数据起步：学生基础信息（学号、姓名、性别、出生日期、身份证号、民族、政治面貌）、班级信息（班级名称、辅导员、入学年份）、登录账号（用户表与学生的关联）、成绩记录（学期、课程、分数）、操作日志（谁在什么时间改了什么）。至于宿舍床位、贫困认定、实习单位这些，可以先留扩展字段，但不作为第一版的主表，否则项目会陷入“无底洞式需求”。

2.2 数据库选型与表关系：MySQL 5.7 以上 + InnoDB，五张表怎么串起来

数据库选型没有悬念，MySQL 是这个方向最常见的标配，原因很简单：开源免费、部署资料多、对 Spring Boot 的支持成熟，而且大部分人本地装的就是 MySQL。版本上建议 5.7 或 8.0，别再用 5.5，因为 5.5 对 utf8mb4 的支持不完整，存 emoji 和生僻字容易出问题。存储引擎固定为 InnoDB，这样才能在外键和事务上获得保障。

表关系按“档案为中心”来设计：student 表是核心，通过 class_id 关联 class_info 表；user 表通过 student_id 一对一关联 student，用于登录鉴权；score_record 表通过 student_id 关联学生，实现“一个学生多条成绩记录”的一对多；archive_log 表独立记录操作行为，不参与业务主链路。外键我建议只在设计文档里体现，代码里不要真的建立物理外键，原因是后续做分页、批量导入和逻辑删除时，物理外键会带来解锁和级联麻烦，用程序逻辑控制一致性更顺手。

2.3 可直接抄的建表 SQL：字符集、索引和注释一次到位

建表 SQL 是核心交付物，建议直接在 Navicat 或命令行里执行，下面这版是我在实际项目和毕设指导中常用的最小完整结构，可以直接抄：

CREATE DATABASE IF NOT EXISTS student_archive DEFAULT CHARACTER SET utf8mb4 DEFAULT COLLATE utf8mb4_general_ci; USE student_archive; CREATE TABLE class_info ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT '班级ID', class_name VARCHAR(50) NOT NULL COMMENT '班级名称', major_name VARCHAR(50) NOT NULL COMMENT '专业名称', enrollment_year INT NOT NULL COMMENT '入学年份', counselor VARCHAR(20) NULL COMMENT '辅导员姓名', create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_class_name (class_name, enrollment_year) ) ENGINE=InnoDB COMMENT='班级信息表'; CREATE TABLE student ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT '学生ID', student_no VARCHAR(20) NOT NULL COMMENT '学号', name VARCHAR(50) NOT NULL COMMENT '姓名', gender TINYINT DEFAULT 1 COMMENT '性别: 1男 2女', birth_date DATE NULL COMMENT '出生日期', id_card VARCHAR(18) NULL COMMENT '身份证号', phone VARCHAR(20) NULL COMMENT '手机号', class_id BIGINT NULL COMMENT '班级ID', status TINYINT DEFAULT 1 COMMENT '状态: 1在读 2休学 3毕业', create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_student_no (student_no), KEY idx_class_id (class_id) ) ENGINE=InnoDB COMMENT='学生基础档案表'; CREATE TABLE user ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT '用户ID', student_id BIGINT NULL COMMENT '关联学生ID，教师/管理员为空', username VARCHAR(30) NOT NULL COMMENT '登录账号', password VARCHAR(100) NOT NULL COMMENT '加密后的密码', role VARCHAR(20) NOT NULL DEFAULT 'student' COMMENT '角色', status TINYINT DEFAULT 1 COMMENT '账号状态', create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_username (username), KEY idx_student_id (student_id) ) ENGINE=InnoDB COMMENT='登录账号表'; CREATE TABLE score_record ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT '成绩ID', student_id BIGINT NOT NULL COMMENT '学生ID', course_name VARCHAR(100) NOT NULL COMMENT '课程名称', semester VARCHAR(20) NOT NULL COMMENT '学期，如2024-2025-1', score DECIMAL(5,2) NOT NULL COMMENT '分数', create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_student_semester (student_id, semester) ) ENGINE=InnoDB COMMENT='学生成绩表'; CREATE TABLE archive_log ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT '日志ID', user_id BIGINT NOT NULL COMMENT '操作人ID', action VARCHAR(50) NOT NULL COMMENT '操作类型', content VARCHAR(255) NULL COMMENT '操作内容描述', create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_user_create (user_id, create_time) ) ENGINE=InnoDB COMMENT='操作日志表';

几个容易被忽略的参数说明：id 统一用 BIGINT，避免将来数据量上来后 int 溢出；字符集用 utf8mb4 而不是 utf8，否则学生姓名里出现特殊字符和 emoji 会直接报错；student_no 和 username 都建唯一索引，这是登录和导入时查重的基础；score 用 DECIMAL(5,2) 而不是 FLOAT，因为浮点数存储成绩会有 0.1 加 0.2 不等于 0.3 的经典精度问题，面试如果聊到这个点会加分；status 字段用 TINYINT 做状态位，比字符串更省空间，也方便后续扩展枚举。五张表建好后，业务代码只需要围绕 student 和 score_record 展开，登录鉴权围绕 user 表展开，日志可以作为切面在 Service 层统一埋点。

3. Spring Boot + MyBatis-Plus 后端落地：从建工程到跑通学生档案的增删改查

3.1 环境准备与工程骨架：JDK 8/17、Maven、IDEA 的常见组合

动手写代码之前，先把环境固定下来。我一般用 JDK 1.8 或 11，配合 Maven 3.6+，IDE 用 IDEA；如果选 Spring Boot 2.7.x，JDK 8 完全够用；如果选 Spring Boot 3.x，则必须上 JDK 17，这一点在 java 环境配置阶段最容易踩版本坑。很多人在第一步就翻车，就是因为在 IDEA 里同时开着几个 JDK 版本，项目必须用 8，但默认环境变量指向了 17。

工程骨架直接在 IDEA 里用 Spring Initializr 创建，也可以去官网生成压缩包再导入。依赖选择不必贪多，Web、MySQL Driver、Lombok 三个就够，MyBatis-Plus 需要手动引入。pom.xml 里最关键的部分如下：

<parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.7.18</version> <relativePath/> </parent> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.5</version> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <scope>runtime</scope> </dependency> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional> </dependency>

这里的版本组合是我在多个项目里验证过不会打架的组合：Spring Boot 2.7.18 是 2.x 系列的收尾版本，修复了大量已知问题；MyBatis-Plus 3.5.5 对 Boot 2.x 支持最稳。如果你一上来就追新用 Boot 3.x，会发现 mybatis-plus-boot-starter 的包名和自动配置方式都变了，排错成本一下子拉高。

3.2 实体类设计与生成建表 SQL：MyBatis-Plus 注解怎么映射字段

MyBatis-Plus 没有像 JPA 那样根据实体类自动建表的能力，但它的注解本身就是建表元数据。我常用的思路是：先写实体类，再用注解把字段名、主键策略、逻辑删除标出来，然后对照注解去写 CREATE TABLE，这个流程虽然不能一键生成，但能保证实体和表结构完全对齐，避免运行时下划线转驼峰映射错乱。

以 student 表为例，实体类这样写：

@Data @TableName("student") public class Student { @TableId(type = IdType.AUTO) private Long id; @TableField("student_no") private String studentNo; private String name; private Integer gender; @TableField("birth_date") private LocalDate birthDate; @TableField("id_card") private String idCard; private String phone; @TableField("class_id") private Long classId; private Integer status; }

关键参数解释：@TableName 指定实体类映射到哪张数据表，表名与类名大小写不同时必须显式声明；@TableId 主键注解，type = IdType.AUTO 表示使用数据库自增主键，如果你的表主键是手动赋值或雪花 ID，这里要改成 ASSIGN_ID；@TableField 用来处理 Java 驼峰属性与数据库下划线字段的映射，比如 birthDate 对应 birth_date。属性上不加注解的字段，MyBatis-Plus 会默认按 map-underscore-to-camel-case 规则转换，所以 name、gender、phone、status 这种单单词字段可以省略注解。

需要注意的是，MyBatis-Plus 本身不根据实体类生成创建表的 SQL 语句，如果需要自动维护表结构，我更建议引入 Flyway，把建表 SQL 放到 db/migration 目录里随应用启动执行。这样既保留了 SQL 的可审查性，又比手动在 Navicat 里执行更规范。

3.3 Service 与 Controller：分页、条件查询、新增编辑删除的完整写法

后端核心不复杂，关键是“一个 Service 接口 + 实现类 + Controller + 统一返回体”。先定义统一返回类 R ，节省后面每个接口重复包装数据的时间：

@Data public class R<T> { private Integer code; private String message; private T data; public static <T> R<T> ok(T data) { R<T> r = new R<>(); r.setCode(200); r.setMessage("success"); r.setData(data); return r; } }

然后写学生档案的业务接口，这里选择直接继承 MyBatis-Plus 的 IService，让框架把通用 Mapper 方法暴露出来：

public interface StudentService extends IService<Student> { Page<Student> getStudentPage(int current, int size, String keyword, Long classId); } @Service public class StudentServiceImpl extends ServiceImpl<StudentMapper, Student> implements StudentService { @Override public Page<Student> getStudentPage(int current, int size, String keyword, Long classId) { LambdaQueryWrapper<Student> wrapper = new LambdaQueryWrapper<>(); wrapper.like(StringUtils.hasText(keyword), Student::getName, keyword) .or(StringUtils.hasText(keyword), w -> w.like(Student::getStudentNo, keyword)) .eq(classId != null, Student::getClassId, classId) .orderByAsc(Student::getStudentNo); Page<Student> page = new Page<>(current, size); return this.page(page, wrapper); } }

这段代码里的逻辑说明：LambdaQueryWrapper 是 MyBatis-Plus 的条件构造器，用 Lambda 表达式引用实体属性，编译期就能发现写错的字段名，比字符串拼接安全得多；like 方法前面带上 StringUtils.hasText(keyword) 作为 condition 参数，keyword 为 null 或空串时该条件自动不生效；注意 or 的写法，我这里先用一个 like 查姓名，再用 or 包一个 like 查学号，如果不套 or 子分组，条件会变成“姓名 like 或 学号 like 且 classId 等于”，逻辑就错了。分页需要配置分页插件，在启动类或配置类里注册 MybatisPlusInterceptor：

@Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; }

Controller 层把 HTTP 语义映射清楚：

@RestController @RequestMapping("/api/student") public class StudentController { @Autowired private StudentService studentService; @GetMapping("/page") public R<Page<Student>> page(@RequestParam int current, @RequestParam int size, @RequestParam(required = false) String keyword, @RequestParam(required = false) Long classId) { return R.ok(studentService.getStudentPage(current, size, keyword, classId)); } @PostMapping public R<Void> save(@RequestBody Student student) { studentService.save(student); return R.ok(null); } @PutMapping public R<Void> update(@RequestBody Student student) { studentService.updateById(student); return R.ok(null); } @DeleteMapping("/{id}") public R<Void> delete(@PathVariable Long id) { studentService.removeById(id); return R.ok(null); } }

参数说明：@RequestParam 绑定的 current 和 size 是页码和每页条数，前端必传；keyword 和 classId 可选，不传时后端条件自动放行。save 方法直接用 MyBatis-Plus 的 save、updateById、removeById，单表 CRUD 不需要写一行 SQL。如果你在 java 面试题里被问到“MyBatis-Plus 有什么缺点”，可以答：复杂多表联查时还是得写自定义 SQL，简单 CRUD 才适合直接用它扛。

4. Vue + Element UI 前端页面：把档案管理做成能过验收的后台界面

4.1 前端工程初始化与跨浏览器设计：用 Vue CLI 搭一个不挑浏览器的后台

后端就绪后，前端我用 Vue 2 + Element UI 这套组合，理由是在跨浏览器支持的设计与实现上最省心：Element UI 的组件已经处理掉大部分 IE 之外的兼容问题，Vue CLI 内置 Babel 会自动转译 ES6 语法，Chrome、Firefox、Edge、Safari 下渲染结果基本一致。如果你用 Vue 3 + Element Plus 也可以，但对刚起步的人来说 Vue 2 的教程和踩坑资料更多，遇到问题更容易搜到答案。

初始化命令：

vue create student-ui npm install element-ui axios

main.js 里这样引入：

import Vue from 'vue' import ElementUI from 'element-ui' import 'element-ui/lib/theme-chalk/index.css' import App from './App.vue' Vue.use(ElementUI) Vue.config.productionTip = false new Vue({ render: h => h(App) }).$mount('#app')

这里的跨浏览器支持主要在 Babel 配置和 CSS 前缀上。Vue CLI 创建项目时 Babel 配置已经是预设的，不需要额外改；Element UI 的样式自带 -webkit、-moz 等前缀，文本溢出和表格宽度在不同浏览器下表现比较稳定。实际开发中我还会在 axios 请求里加一个超时时间和统一的错误提示，避免某个浏览器下请求长时间挂起导致页面看起来“死掉”。

4.2 学生列表页：分页表格 + 搜索表单 + 弹窗编辑的实现

列表页是这套系统的门面，也是答辩时最容易吸引眼球的地方。拆分好组件后，主体工作只有三块：搜索表单、el-table、el-pagination。下面这个组件片段删减了样式代码，保留了核心逻辑：

<template> <div> <el-form :inline="true"> <el-form-item label="关键字"> <el-input v-model="query.keyword" placeholder="姓名/学号" clearable /> </el-form-item> <el-form-item> <el-button type="primary" @click="loadData">查询</el-button> </el-form-item> </el-form> <el-table :data="list" border stripe> <el-table-column prop="studentNo" label="学号" width="120" /> <el-table-column prop="name" label="姓名" width="100" /> <el-table-column prop="gender" label="性别" width="80"> <template slot-scope="scope"> {{ scope.row.gender === 1 ? '男' : '女' }} </template> </el-table-column> <el-table-column prop="phone" label="手机号" /> <el-table-column label="操作" width="180"> <template slot-scope="scope"> <el-button size="mini" @click="openEdit(scope.row)">编辑</el-button> <el-button size="mini" type="danger" @click="removeRow(scope.row)">删除</el-button> </template> </el-table-column> </el-table> <el-pagination background layout="total, prev, pager, next" :total="total" :current-page.sync="query.current" :page-size="query.size" @current-change="loadData" /> </div> </template> <script> import axios from 'axios' export default { data() { return { list: [], total: 0, query: { current: 1, size: 10, keyword: '' } } }, methods: { async loadData() { const res = await axios.get('/api/student/page', { params: this.query }) this.list = res.data.data.records this.total = res.data.data.total }, openEdit(row) { // 这里打开弹窗，把 row 拷贝到表单对象，避免直接改表格数据 console.log(row) }, async removeRow(row) { await axios.delete(`/api/student/${row.id}`) this.loadData() } }, created() { this.loadData() } } </script>

这段代码的关键点：el-table-column 使用 prop 绑定字段，显示 0/1 这类数字状态时用 slot-scope 做格式化，比在数据源里预处理更直观；el-pagination 用 current-page.sync 做双向绑定，页码变化时自动触发 loadData；axios 的 params 会序列化对象，后端再用 @RequestParam 接，字段名没有歧义。开发环境下需要解决跨域，在 vue.config.js 里配置代理：

module.exports = { devServer: { proxy: { '/api': { target: 'http://localhost:8080', changeOrigin: true } } } }

代理配置的原因很简单：前端跑在 8081，后端跑在 8080，浏览器认为端口不同就是跨域。有了代理后，前端代码里写 /api 开头的路径，开发服务器会代理到后端地址，规避了生产环境还要配 Nginx 的麻烦。

4.3 照片上传与回显：FormData 提交和浏览器兼容细节

学生档案里“照片上传”几乎必做，这里隐藏着不少浏览器兼容细节。前端上传组件我用 el-upload，配合 FormData 提交，不直接传 base64 字符串，因为大照片转 base64 会让请求体膨胀到几兆，后端解析也慢。核心代码如下：

<el-upload action="#" :show-file-list="false" :before-upload="onBeforeUpload" accept="image/jpeg,image/png" > <el-button size="small">上传照片</el-button> </el-upload>

async onBeforeUpload(file) { const formData = new FormData() formData.append('file', file) const res = await axios.post('/api/student/upload', formData, { headers: { 'Content-Type': 'multipart/form-data' } }) return false }

accept 控制在 Chrome 和 Edge 下会过滤文件类型，但在 Firefox 下只是提示不是强制，所以后端还需要校验文件扩展名和 MIME 类型。照片回显时，我一般让后端把文件保存到本地磁盘，然后返回一个带时间戳的图片访问路径，前端在 el-image 或 img 标签里拼接后端地址。如果照片文件名不变，浏览器缓存会让替换后的照片不刷新，这就是我强调“带时间戳”的原因，这也是很多毕设项目演示照片老是旧图的血泪经验。

5. 避坑清单：MyBatis-Plus、Tomcat、MySQL 这些地方最容易翻车

5.1 查询结果全是 null：下划线转驼峰没生效的真相

现象：前端表格能返回记录数，但 studentNo、birthDate 这类字段全部为 null，name、phone 却正常。第一次遇到时我以为是 JSON 序列化问题，折腾了半天。

原因：MyBatis-Plus 的 mapUnderscoreToCamelCase 默认是 true，但如果你在 application.yml 里自定义了 configuration 配置，没有把这一项显式打开，或者直接用了原生 MyBatis 的 ResultMap，驼峰映射就会失效。另外，实体类里没加 @TableField 的长字段，其实依赖的就是这个全局配置。

解决：在 application.yml 中显式声明：

mybatis-plus: configuration: map-underscore-to-camel-case: true

还有另一个细节：如果你用 Lombok 的 @Data，字段命名是 studentNo，那么 JSON 序列化后前端拿到的是 studentNo；但有的同事会把字段命名为 student_no，前者才是 Java 标准驼峰命名，后者的风格会导致前端也需要跟着用下划线，统一比什么都重要。

5.2 启动时数据库连接报错：serverTimezone 这个参数不能省

现象：Spring Boot 启动时报错，类似于 stating up 时遇到 Cannot create PoolableConnectionFactory，或者控制台里出现 The server time zone value 提示。

原因：MySQL 8.0 之后，驱动要求客户端显式指定时区，而很多人数据库连接串还是照着 MySQL 5.6 时代抄的，没有加 serverTimezone 参数。即使能连上，日期字段也会出现和本地时间相差 8 小时的情况。

解决：连接串写成这样，两个参数一个都不能少：

url: jdbc:mysql://localhost:3306/student_archive?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai

这里 serverTimezone 用 Asia/Shanghai，不要用中国标准时间这种中文值，因为某些驱动版本解析不了。没了 useSSL=false，你还会时不时看到 SSL 握手警告，虽然不影响运行，但日志刷得让人心慌。

5.3 前端调后端接口被 403：跨域不是玄学，是没配置 CORS

现象：前端页面能打开，但 axios 请求直接失败，控制台提示 Access to XMLHttpRequest has been blocked by CORS policy，Network 标签里显示状态码 403。

原因：浏览器同源策略拦截了跨端口请求。开发时前端 8081、后端 8080，这就是两个源；有时前端用了代理，但请求路径没有走代理前缀，也会白白踩跨域。

解决：在后端写一个全局跨域配置类，不用在每个 Controller 上加注解：

@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); } }

注意 allowedOriginPatterns("") 和 allowCredentials(true) 要搭配使用，原来用 allowedOrigins("") 在某些版本下会报“origin pattern cannot be null”的错。这个配置一旦加上，前后端联调会顺畅很多，属于典型的“当初觉得玄学，实际就是规范”的坑。

5.4 上传档案照片报错：Spring Boot 和 Tomcat 的限制是双层的

现象：小文件上传正常，超过 1MB 的照片一传就报 FileSizeLimitExceededException，或者提示请求大小超出限制。

原因：Spring Boot 内置的 multipart 配置默认单文件最大 1MB，总请求最大 10MB；同时 Tomcat 自身还有一个 maxSwallowSize，默认 2MB。如果只调 Spring 的配置，不调 Tomcat 的，报错依然存在，这就是双门槛。

解决：在 application.yml 中同时配置：

spring: servlet: multipart: enabled: true max-file-size: 10MB max-request-size: 20MB server: tomcat: max-swallow-size: 20MB

max-swallow-size 这个参数的含义是 Tomcat 允许丢弃的未读取请求体大小，表单提交时文件超出会被这里拦截。我见过很多人只改了 multipart 配置，问题依旧，最后把 Tomcat 配置加上才消停。这个坑在答辩现场翻车率极高，建议提前用超过 2MB 的照片实测一遍。

5.5 插入数据主键冲突：自增 ID 和雪花算法你要选一个

现象：新增学生时偶尔成功，偶尔立刻抛出 Duplicate entry 'xxx' for key 'PRIMARY'，但数据库里明明没有这条记录。

原因：MyBatis-Plus 的 ID 默认策略是 ASSIGN_ID，会生成一个雪花 ID，也就是 19 位左右的数字。如果表的主键是 AUTO_INCREMENT，实体类里又没有声明 @TableId(type = IdType.AUTO)，MyBatis-Plus 会把雪花 ID 当作主键塞进 SQL，但数据库的自增序列并没有跳到这个值，下次插入时自增 ID 和雪花 ID 就撞车了。

解决：实体类主键上显式声明：

@TableId(type = IdType.AUTO) private Long id;

如果你的表确实不想用自增，那就把数据库字段改成 BIGINT，并让 MyBatis-Plus 用 ASSIGN_ID 生成雪花主键。不要一会儿用自增、一会儿依赖默认策略，这属于设计不一致，不是框架 bug。我建议学生档案这类低并发管理系统直接走数据库自增，简单直观，写 SQL 排查时也更容易理解和调试。

6. 进阶玩法：用代码生成器把 CRUD 变成模板，再给学生档案加上 Excel 导出

6.1 MyBatis-Plus CodeGenerator 一键生成整套 CRUD 骨架

表结构调整后，手写实体、Mapper、Service、Controller 非常浪费时间。MyBatis-Plus 的代码生成器可以把这张表的骨架一次性生成，常见做法是在启动类里临时加一段生成逻辑，跑完就删。你需要先引入 mybatis-plus-generator 和 velocity-engine-core 依赖，然后配置数据源和表名，执行后代码会自动落到指定包下。生成的结果可以直接省掉手写 CRUD 的时间，但要注意生成器默认生成的 Controller 方法粒度很粗，比如会把 save 和 update 合并成一个方法，你仍然要按业务边界拆开，不能指望它一步到位。这个技巧能让整个项目后期维护效率提升不少。

6.2 学生档案导出 Excel：用 EasyExcel 写一个带模板的下载接口

导出 Excel 是答辩时很加分但又容易临时加班的功能。我一般用 Alibaba EasyExcel 而不是 Apache POI 直接操作，因为 EasyExcel 内存占得少，API 更贴近业务。先引入依赖：

<dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>3.3.4</version> </dependency>

在 Controller 里加一个导出接口，直接让浏览器下载：

@GetMapping("/export") public void export(HttpServletResponse response) throws IOException { response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"); response.setCharacterEncoding("utf-8"); response.setHeader("Content-disposition", "attachment;filename=student.xlsx"); List<Student> list = studentService.list(); EasyExcel.write(response.getOutputStream(), Student.class) .sheet("学生档案") .doWrite(list); }

这段代码的关键是 setContentType 必须用 Excel 的标准 MIME 类型，否则部分浏览器会把它当成 HTML 下载，打开后乱码；Student.class 里可以用 @ExcelProperty 注解指定列名和顺序，比如学号、姓名、性别、手机号。导出大列表时一般还要加 async 或限制导出条数，学生档案规模不会太大，所以这里直接 list() 是最简单可靠的写法。

最后说一点私人教训：我当年做这款系统时，最浪费时间的不是编码，而是反复改表结构。今天加个字段，明天加张表，前后端跟着一起动，漏掉一个地方就要调试半天。后来我养成了一个习惯：任何改动先落 SQL 脚本、再动实体类、最后才写接口和页面，顺序一旦乱了，数据模型和业务逻辑就开始互相打架。你能看到这里，说明你也在认真对待这个方向，希望帮到你，早点把系统跑起来，再把细节打磨到位。

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