简介：《学生信息管理系统》程序资源包面向学校教务部门、教师及初学者，围绕学生信息录入、查找、删除、修改、排序、统计与显示等核心操作展开，可帮助用户高效处理日常教务数据，也适合作为课程设计、毕业设计或入门项目的参考。资源以zip压缩包形式提供，共4个文件，包含2份doc文档（分别对应程序使用说明与配置说明）、1个可直接运行的exe可执行程序，以及1份py源程序，整体仅5.96MB，结构清晰、便于学习。截至目前已有142人学习下载。通过源码与配套文档，读者可以实际学习数据库INSERT、UPDATE、SELECT等语句的运用，理解查找、排序等算法在真实程序中的落地，以及删除操作如何维护数据完整性和一致性；也可直接运行exe体验完整流程，再对照源码逐段分析，有助于快速掌握小型管理系统从界面设计到业务逻辑的实现思路。
1. 学生信息管理系统：为什么代码会写了，答辩还是翻车
拿到《学生信息管理系统》的课程设计任务和一份“包含源码”的程序包，大多数人第一反应是：增删改查嘛，跑起来录几条学生信息就行。但真正到了验收或答辩现场，翻车的恰恰是那些看起来简单的点——分页第二页数据乱跳、中文变成问号、换台电脑就起不来，老师随口问一句“你删掉的学号还能不能再录进来”，你才发现自己用的是物理删除。这篇笔记按最常见的 Java 课程设计形态来讲：Swing 桌面端 + MySQL + JDBC，把技术栈选择、工程骨架、建表、连接层、登录、分页、批量导入和避坑一条线走完。适合正在做课程设计的学生，也适合要把一堆零散源码整理成可交付程序的新手。
2. 做这个程序前必须先定的三件事：技术栈、工程骨架和源码目录
2.1 三种技术栈怎么选：Java Swing、Python Tkinter 还是 Web 版
任何一套学生信息管理系统，都绕不开“界面、业务、数据库”三层。先别急着写实体类，先回答三个问题：程序跑在哪、数据库用什么、答辩环境允不允许联网。这三件事直接决定后面是顺利收尾还是反复返工。
| 技术栈 | 典型场景 | 课设风险 | 我的建议 |
|---|---|---|---|
| Java Swing + JDBC + MySQL | 桌面课设，单机演示 | 依赖 JDK 和 MySQL 环境 | 最稳，逻辑全部在同一个 JVM 里，便于答辩讲解 |
| Python Tkinter + SQLite | Python 课设，轻量演示 | SQLite 和 MySQL 语法有差异，换库要改 SQL | 适合没装 MySQL 的机器，但不够“像企业项目” |
| JavaWeb（Servlet/JSP）+ MySQL | Web 课设 | 要装 Tomcat，前端样式容易失控 | 如果想引 MyBatis 加分，复杂度会明显上升 |
| 微信小程序 / 前后端分离 | 展示型项目 | 需要后端服务常驻，演示链路长 | 不推荐作为单门课设的主交付物 |
网上找“java课程设计案例源码”或“php源码”能搜到大量同名项目，但质量参差。常见问题是：代码能编译却跑不通、数据库脚本缺失、依赖 jar 不完整。你会搜到的还有“免费python源码大全”里各类 Python 版学生管理系统，大多用 Tkinter 或 Flask 写，选型本身没问题，但往往没有测试数据，也没有打包说明，真正跑起来才是分水岭。所以这篇笔记以 Java Swing 为例展开，如果你拿到的源码是 Python 或 PHP，后面关于建表、登录、分页、避坑的思路一样能用。
2.2 初始化 Maven 工程：一张能直接照抄的目录结构
拿到手的第一件事，不是双击运行，而是把源码目录摊开看。如果 .java、.jar、.sql 全堆在一个文件夹里，直接重建骨架，别犹豫。这种“平面结构”后期改一个查询都要全局翻文件，更别说在答辩时跟老师讲清楚模块划分。
student-info-system/ ├── pom.xml ├── src/ │ ├── main/ │ │ ├── java/com/course/stu/ │ │ │ ├── App.java # 程序入口，只负责启动 │ │ │ ├── ui/ # Swing 界面层 │ │ │ ├── service/ # 业务逻辑层 │ │ │ ├── dao/ # 数据访问层 │ │ │ ├── entity/ # 实体类 │ │ │ └── util/ # DBUtil、PasswordUtil 等 │ │ └── resources/ │ │ ├── jdbc.properties │ │ └── log4j2.xml │ └── test/java/ ├── sql/ │ ├── schema.sql │ └── data.sql └── README.md这套结构的好处是各层职责一眼能看出来：UI 不写 SQL，DAO 里不弹窗口，service 夹在中间做校验和事务。App.java 只做一件事——初始化界面。测试数据统一放 sql/data.sql，数据库建好后执行一次就有几十条学生记录可演示，省去录入时间。
我一般会在 README 里写清楚三件事：JDK 版本、MySQL 版本、从建库到启动的五个步骤。很多源码包没有 README，等于把“如何跑起来”的成本全部甩给了使用者，这是最容易被扣分的地方。
2.3 pom.xml 里的五个关键坐标：驱动、版本和打包方式
Maven 不是课设强制要求，但建议用。它能帮你固定依赖版本，更重要的是能打出“带依赖的可执行 jar”。否则你本机能跑，把源码发给同学或考到答辩电脑上就报 NoClassDefFoundError。
<properties> <maven.compiler.source>8</maven.compiler.source> <maven.compiler.target>8</maven.compiler.target> </properties> <dependencies> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.33</version> </dependency> <dependency> <groupId>com.opencsv</groupId> <artifactId>opencsv</artifactId> <version>5.9</version> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-shade-plugin</artifactId> <version>3.5.1</version> <executions> <execution> <phase>package</phase> <goals><goal>shade</goal></goals> </execution> </executions> <configuration> <transformers> <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"> <mainClass>com.course.stu.App</mainClass> </transformer> </transformers> </configuration> </plugin> </plugins> </build>几个参数别乱改。maven.compiler.source和target固定成 8，是防止本机 JDK 17 编译出的 class 文件在老师旧 JDK 上跑不起来。mysql-connector-java 的版本要跟着数据库走：MySQL 5.7 用 5.x 驱动，MySQL 8 用 8.0.x，两者驱动类名不一样。shade 插件负责把 MySQL 驱动和 opencsv 全部打进同一个 jar，这样java -jar时不需要额外配 classpath。
如果只是批量导入 CSV，用 opencsv 比 POI 干净得多。POI 读写 .xlsx 功能强，但依赖体积大、API 复杂，课设里非要用 Excel 文件再考虑它。
3. 学生表与登录表的设计：把数据库建成不用返工的样子
3.1 建表 SQL 里必须有的五个字段：学号索引、软删除、时间戳
“建表”看起来是体力活，但大部分返工都出在表结构上。很多初版设计只有 student_no、name、gender、class_name 四个字段，等做到“删除学生”和“批量导入”时才发现：学号重复检查做不了、删除后无法恢复、搜索班级没有索引。
下面这份 SQL 是常见的课设落地方案，可以直接执行：
CREATE DATABASE stu_info DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE stu_info; CREATE TABLE student ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_no VARCHAR(20) NOT NULL COMMENT '学号', name VARCHAR(50) NOT NULL, gender TINYINT NOT NULL DEFAULT 1 COMMENT '1男 0女', birthday DATE, phone VARCHAR(20), class_name VARCHAR(50), created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, deleted BIGINT NOT NULL DEFAULT 0 COMMENT '0未删除，删除时写入id', UNIQUE KEY uk_student_no (student_no, deleted), KEY idx_class_name (class_name) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE sys_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, salt VARCHAR(32) NOT NULL, password_hash VARCHAR(64) NOT NULL, role VARCHAR(20) NOT NULL DEFAULT 'admin' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;重点说说deleted字段。这里的 deleted 不是常用的 TINYINT 0/1，而是 BIGINT，默认 0。逻辑删除执行的是UPDATE student SET deleted = id WHERE id = ?。配合唯一索引uk_student_no (student_no, deleted)，可以保证同一学号在“未删除”状态只能存在一条；已删除的旧记录因为 deleted 等于各自 id，互不冲突，学号可以重新录入。这是逻辑删除里一个很容易踩的设计细节，如果 deleted 固定写 1，同一学号删除两次就会触发唯一键冲突。
created_at和updated_at建议加上，虽然增删改查里用不到，但答辩时展示数据变化时间，或者排查重复录入都靠它。class_name 加普通索引，是因为按班级筛选是最常见的查询路径，否则数据量到几千条后全表扫描会很慢。字符集统一 utf8mb4，排序规则用 utf8mb4_unicode_ci，避免中文排序和比对出问题。
3.2 JDBC 连接层：把数据库账号密码从代码里挪出去
你会见到很多课设源码把数据库用户名密码直接写在 DBUtil 类里，像这样：DriverManager.getConnection(url, "root", "123456")。在本机跑没问题，可一旦源码发给别人、或者放到答辩电脑上，改密码就得重新编译。更麻烦的是，代码评审老师一眼就会问：配置和代码为什么不分离？
正确做法是把连接信息放 resources 下的 jdbc.properties：
jdbc.driver=com.mysql.cj.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/stu_info?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true jdbc.username=root jdbc.password=123456然后写一个静态工具类：
package com.course.stu.util; import java.io.InputStream; import java.sql.Connection; import java.sql.DriverManager; import java.util.Properties; public class DBUtil { private static String url; private static String username; private static String password; static { try (InputStream in = DBUtil.class.getClassLoader() .getResourceAsStream("jdbc.properties")) { Properties props = new Properties(); props.load(in); Class.forName(props.getProperty("jdbc.driver")); url = props.getProperty("jdbc.url"); username = props.getProperty("jdbc.username"); password = props.getProperty("jdbc.password"); } catch (Exception e) { throw new ExceptionInInitializerError("初始化数据库连接失败，请检查 jdbc.properties"); } } public static Connection getConnection() throws Exception { return DriverManager.getConnection(url, username, password); } }这段代码里有几个参数值得注意。characterEncoding=utf8决定 JDBC 与 MySQL 之间用 UTF-8 传输中文，少了它最容易出现乱码。serverTimezone=Asia/Shanghai是因为 MySQL 8 的 JDBC 驱动会校验时区，不设置可能直接抛异常。allowPublicKeyRetrieval=true主要用于 MySQL 8 默认的 caching_sha2_password 认证插件下首次连接获取公钥，加了之后能少一类“Public Key Retrieval is not allowed”的报错。
用类加载器读取 properties，而不是用文件绝对路径，好处是打包成 jar 后资源依然能被读到。如果以后想换数据库，比如切到 SQLite，只需要改 properties，不用动 Java 代码。
3.3 用 PreparedStatement 代替 Statement：一个参数位省掉整张表的灾难
课设源码里最常见的坏味道是字符串拼接 SQL：
Statement stmt = conn.createStatement(); stmt.executeQuery("SELECT * FROM student WHERE name = '" + name + "'");这种写法的直接后果是：姓名里带单引号就报错，更严重的是存在 SQL 注入风险。老师只要演示一次在搜索框输入' or '1'='1，整个表的数据就被拖出来，场面很难看。不要赌答辩老师不会试，用 PreparedStatement 成本极低。
public Student findByStudentNo(String studentNo) throws Exception { String sql = "SELECT id, student_no, name, gender, birthday, class_name " + "FROM student WHERE student_no = ? AND deleted = 0"; try (Connection conn = DBUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setString(1, studentNo); try (ResultSet rs = ps.executeQuery()) { if (rs.next()) { Student s = new Student(); s.setId(rs.getLong("id")); s.setStudentNo(rs.getString("student_no")); s.setName(rs.getString("name")); s.setGender(rs.getInt("gender")); s.setBirthday(rs.getDate("birthday")); s.setClassName(rs.getString("class_name")); return s; } } } return null; }?占位符配合setString，JDBC 驱动会负责转义特殊字符，参数永远不会被当成 SQL 指令执行。try-with-resources 写法保证 Connection、PreparedStatement、ResultSet 在退出 try 块时自动关闭，避免连接泄漏。对于程序长时间开着的桌面应用，连接泄漏会导致运行几个小时后突然报“Too many connections”，这是很典型的隐藏故障。
需要说明的是，这里每次查询都新建连接，在“课设规模”（几百人、单机演示）下完全够用。如果以后数据量上来或要做 Web 版，再考虑引入连接池，比如 HikariCP。课设阶段不要为了炫技引入一堆框架，核心 SQL 都走 PreparedStatement，已经能体现工程意识了。
4. 登录、分页、批量导入：三个让源码“有含金量”的功能模块
4.1 登录校验：再也不要拿明文密码去数据库比对
学生信息管理系统一般都有登录窗口。最常见的翻车写法是注册时把密码原样存进数据库，登录时执行SELECT * FROM sys_user WHERE username = ? AND password = ?。问题是，数据库一旦被导出，所有账号等于裸奔；而且只要在演示时打开数据库表，老师看到明文密码，印象分会直接掉一档。
不要自己去发明加密算法。常见的做法是“随机盐 + SHA-256”。每次注册都生成一个随机盐，把盐和密码拼起来做哈希，盐本身明文存在用户表里。登录时取出盐，对输入密码做同样的哈希，再比较结果。
package com.course.stu.util; import java.nio.charset.StandardCharsets; import java.security.MessageDigest; public class PasswordUtil { public static String hashPassword(String rawPassword, String salt) throws Exception { MessageDigest md = MessageDigest.getInstance("SHA-256"); md.update(salt.getBytes(StandardCharsets.UTF_8)); byte[] hashed = md.digest(rawPassword.getBytes(StandardCharsets.UTF_8)); StringBuilder sb = new StringBuilder(); for (byte b : hashed) { sb.append(String.format("%02x", b)); } return sb.toString(); } }登录时的校验逻辑建议放在 service 层，而不是 UI 层：
public boolean checkLogin(String username, String rawPassword) throws Exception { User user = userDao.findByUsername(username); if (user == null) { return false; } String actual = PasswordUtil.hashPassword(rawPassword, user.getSalt()); return actual.equals(user.getPasswordHash()); }代码里每一步都有目的。先查用户而不是先讲密码，是为了避免通过报错信息暴露“用户不存在”。盐每人不同，即使两个用户密码相同，哈希结果也不一样。为什么不用 MD5？因为 MD5 计算速度太快，配合彩虹表很容易被批量破解；SHA-256 在课设场景下已经足够，没必要再引 Spring Security。
4.2 分页查询：LIMIT 的偏移量为什么要自己算而不是猜
分页是很多新手源码的“重灾区”。功能看起来正常，但代码里用的是LIMIT page * pageSize。比如每页 10 条，第一页应该取 0 到 9，第二页如果从 10 开始，那么第一页的第 10 条其实没被展示，而第二页第 1 条正是它——数据被跳过了一行。
正确公式是offset = (page - 1) * pageSize。也就是第一页从头开始，第二页跳过前 10 条。除此之外，分页查询还必须带稳定的 ORDER BY，否则 MySQL 返回顺序不固定，翻页时会出现重复或遗漏。
public PageResult<Student> pageStudents(int page, int pageSize, String keyword) throws Exception { if (page < 1) page = 1; if (pageSize > 100) pageSize = 100; int offset = (page - 1) * pageSize; String where = " WHERE deleted = 0"; if (keyword != null && !keyword.trim().isEmpty()) { where += " AND (student_no LIKE ? OR name LIKE ?)"; } String countSql = "SELECT COUNT(*) FROM student" + where; String dataSql = "SELECT id, student_no, name, gender, birthday, class_name FROM student" + where + " ORDER BY id DESC LIMIT ?, ?"; try (Connection conn = DBUtil.getConnection()) { long total = 0; try (PreparedStatement ps = conn.prepareStatement(countSql)) { if (keyword != null && !keyword.trim().isEmpty()) { String like = "%" + keyword.trim() + "%"; ps.setString(1, like); ps.setString(2, like); } ResultSet rs = ps.executeQuery(); if (rs.next()) { total = rs.getLong(1); } } List<Student> list = new ArrayList<>(); try (PreparedStatement ps = conn.prepareStatement(dataSql)) { if (keyword != null && !keyword.trim().isEmpty()) { String like = "%" + keyword.trim() + "%"; ps.setString(1, like); ps.setString(2, like); } ps.setInt(3, offset); ps.setInt(4, pageSize); ResultSet rs = ps.executeQuery(); while (rs.next()) { // 映射 Student 对象并加入 list } } return new PageResult<>(total, list); } }注意两个 PreparedStatement 里的参数位置。count 语句先绑两个 LIKE 参数，data 语句里同样是两个 LIKE 参数在前，LIMIT 的 offset 和 pageSize 排在第 3、第 4 位。很多人只在 count 里绑了参数，data 里忘了绑，或者把偏移量和 pageSize 顺序写反，运行时报Parameter index out of range。
分页结果对象里至少包含 total 和 list。total 用于界面显示“共 N 条，共 M 页”，也是计算“下一页是否可用”的依据。page > total / pageSize时按钮应该置灰。这套逻辑不复杂，但能避免用户翻到空白页。
4.3 批量导入：Excel 行号、空值与重复学号的三个边界检查
“批量导入学生名单”是课设源码里最能体现完整性的功能。老师通常会在答辩现场要求导入一份新的班级名单，如果源码只能手工录入，就少了一个亮点。常见的做法是用 opencsv 解析 CSV，如果学校提供的模板是 .xlsx，再考虑引入 POI。
下面这段代码是 CSV 导入的核心骨架：
public int importStudents(File file) throws Exception { int successCount = 0; try (CSVReader reader = new CSVReader( new InputStreamReader(new FileInputStream(file), StandardCharsets.UTF_8))) { List<String[]> rows = reader.readAll(); if (rows.isEmpty()) { throw new IllegalArgumentException("文件为空"); } for (int i = 1; i < rows.size(); i++) { String[] row = rows.get(i); if (row.length < 4) { continue; } String studentNo = row[0].trim(); String name = row[1].trim(); if (studentNo.isEmpty() || name.isEmpty()) { continue; } if (!studentNo.matches("\\d{5,20}")) { throw new IllegalArgumentException("第 " + (i + 1) + " 行学号格式错误: " + studentNo); } if (studentDao.existsByStudentNo(studentNo)) { throw new IllegalArgumentException("第 " + (i + 1) + " 行学号重复: " + studentNo); } studentDao.insertStudent(row); successCount++; } } return successCount; }三个边界检查缺一不可。第一个是跳过表头：i从 1 开始，因为第 0 行是表头，如果不跳，第一行数据会被当成学号写进库。第二个是空行和字段不足：有些表格末尾会有空行，直接跳过而不是报错中断。第三个是重复学号：插入前调用existsByStudentNo检查deleted = 0的记录里是否已存在同样学号，避免数据库唯一键冲突。
报错信息里的行号必须用i + 1。因为rows的索引从 0 开始，但用户打开 CSV 看到的第一行是表头，第二行才是第一条数据。你定位到 rows 的第 5 行，文件里其实是第 6 行，差一行会让使用者找半天。这类细节正是课设源码和“能交付的源码”之间的差距。
导入大批量数据时还要考虑事务。比如 500 行数据，第 300 行格式错误，如果前面 299 行已经插入，数据库就处于一半成功一半失败的状态。常见做法是整体回滚，或者收集错误行号最后统一反馈。整体回滚的写法很固定：
Connection conn = DBUtil.getConnection(); conn.setAutoCommit(false); try { // 循环插入 conn.commit(); } catch (Exception e) { conn.rollback(); throw e; } finally { conn.setAutoCommit(true); conn.close(); }把setAutoCommit(false)放在 try 块之前，commit 放在循环全部结束后，任何一个插入失败都会触发 rollback。这一步在答辩里很加分，因为很多人连“事务是什么”都答不清楚。
5. 学生信息管理系统避坑清单：从跑不起来到答辩被问倒
这章是我最想让你先看的部分。很多学生信息管理系统源码本身逻辑没问题，真正让项目翻车的是环境、编码和外键这些细节。每一条都按现象、原因、解决来写，对照着排查。
5.1 连不上数据库：驱动类找不到和认证失败是两回事
现象：程序启动后第一次点登录就报ClassNotFoundException: com.mysql.jdbc.Driver，或者用户名密码都对却报Access denied for user 'root'@'localhost'。
原因：驱动类名用错了。MySQL 5.x 时代的驱动类是com.mysql.jdbc.Driver，MySQL 8 之后它被废弃，新驱动类在com.mysql.cj.jdbc.Driver包下。还有另一种情况：pom.xml 里写的驱动版本和本地 MySQL 服务器版本差异过大，导致认证插件对不上。
解决：先确认jdbc.properties里 driver 和 pom 依赖版本匹配。MySQL 8 就用com.mysql.cj.jdbc.Driver加 8.0.x 驱动。连接串里建议保留useSSL=false&allowPublicKeyRetrieval=true。如果是在本机开发，不要用 localhost 之外的主机名，避免 host 解析问题。
5.2 中文乱码：连接串里少了 characterEncoding 全表变问号
现象：界面和数据库里的中文全部变成??，或者英文正常、中文乱码。往库里插入一段中文，用命令行查看也是乱码。
原因：数据库字符集、连接串字符集、代码文件字符集三层没有统一。很多老教程用 GBK 建库，或者连接串里不写characterEncoding，JDBC 会按服务器默认字符集传输，一旦默认不是 UTF-8 就会乱。
解决：数据库、表、列都用 utf8mb4，连接串加characterEncoding=utf8，统一后的标准写法就是 3.2 节那份 jdbc.properties。另外，源码文件本身要用 UTF-8 保存，如果 IDE 默认是 GBK，字符串常量也会变成乱码。判断时先用数据库命令行工具直接插一条中文，如果能正常显示说明代码没问题，问题在连接串。
5.3 删除学生时外键卡住或把成绩表一起删没：物理删除与级联删除
现象：执行DELETE FROM student WHERE id = ?时报Cannot delete or update a parent row: a foreign key constraint fails。或者为了省事给外键加了ON DELETE CASCADE，删掉一个学生后，成绩表里他的所有记录也被连带删除。
原因：如果有成绩表或选课表外键指向 student.id，主表记录就不能随便物理删除。CASCADE 看起来很顺手，但它把“删除学生”变成了“清除该学生一切痕迹”，答辩时老师问到数据完整性，很难解释为什么历史成绩消失了。
解决：采用第 3 章设计的逻辑删除。删除学生时执行UPDATE student SET deleted = id WHERE id = ? AND deleted = 0，所有查询默认加AND deleted = 0。如果系统确实允许物理删除，也应该先删除子表记录再删除主表，并且放在一个事务里。这是课设源码里最容易暴露设计缺陷的地方。
5.4 换一台电脑就起不来：Could not find or load main class 与环境变量
现象：源码在本机跑得挺好，用 maven 打成 jar 后，到答辩电脑执行java -jar xxx.jar报Could not find or load main class，或者直接闪退，连错误信息都看不到。
原因：没有使用 shade 插件，打包出的 jar 里没有 MySQL 驱动和 opencsv 这些依赖；或者 mainClass 配置指向了不存在的类。还有一种常见情况：目标电脑根本没装 JRE，双击 bat 文件就一闪而过。
解决：pom.xml 里配好 maven-shade-plugin，指定mainClass为com.course.stu.App，执行mvn clean package。启动脚本加一行pause，让窗口停住，报什么错都能看清：
@echo off java -jar target\student-info-system.jar pause如果目标电脑连 JDK 都没有，再多源码也白搭。交交付物清单时，把 JDK 版本写进 README，最稳妥的做法是演示前先到答辩机器上跑一遍启动脚本。
5.5 分页第二页数据乱跳：排序字段不稳定造成的重复与丢失
现象：第一页和第二页出现同一条记录，或者有两页之间夹着一条没显示的数据。列表看起来总数对，翻页就对不上。
原因：分页 SQL 只写了 LIMIT，没写 ORDER BY；或者写了ORDER BY name，但班级里有两个同名同学，排序不稳定，MySQL 的返回顺序在两次查询之间可能变化。
解决：分页查询必须用唯一性强的字段排序，一般用ORDER BY id DESC。如果要按姓名排序，排序字段后面再加一个 id 做 tie-breaker，比如ORDER BY name, id。另外，count 查询和 list 查询的 WHERE 条件必须完全一致，关键字搜索时两次都要绑定同样的 LIKE 参数，否则总数对不上，最后一页会出现空白。
6. 让这份源码真正可以验收：测试数据脚本、演示路径与收尾打包
6.1 用一份 30 条的测试数据脚本代替手工点键盘
演示时最怕冷场：登录进去，列表是空的，现场录学生又慢又容易出错。我会在 sql/data.sql 里准备 5 个班、30 条以上学生记录，班级名覆盖“软件2101、网络2202”等，方便展示按班级筛选。数据里刻意安排两个同名不同班的学生，用来演示分页搜索和排序。如果只用一条数据，分页和搜索功能根本没有展示机会。
6.2 演示前跑一遍「一分钟演示路径」
固定演示顺序，不要跳着点。我的习惯是：登录 → 查看首页统计 → 按班级筛选 → 搜索姓名 → 翻到第二页 → 新增一条学生 → 批量导入 5 条 CSV → 删掉一条测试记录并解释逻辑删除。这条路径能覆盖登录校验、分页边界、查询速度、事务回滚四个老师最爱问的点。每次改完代码，都按这条路径走一遍，确认没有报错再收工。
6.3 交付物清单：至少包含这四样
源码目录、pom.xml、sql 初始化脚本、README 运行说明，四样缺一样都算不上“包含源码”的可交付程序。README 里要写清 JDK 版本、MySQL 版本、建库步骤、默认账号密码、启动命令。数据库脚本要保证在干净环境执行一次就能把表和测试数据全部建好，而不是把你自己机器上的库导出一份交上去——那种导出文件里带着一堆历史脏数据，老师一眼就能看出来。
把这三件事养成习惯后，源码包就不是一堆代码文件的堆叠，而是别人拿到手能跑、能验收、能继续维护的东西。我之前见过太多本机正常、换环境就崩的例子，根源大多是省掉了测试数据和启动说明。我现在每做一个课设项目，都会先写 data.sql，再写 README，最后才写代码收尾。这个顺序能帮你提前发现自己缺了什么。希望帮到你。
本文还有配套的精品资源，点击获取
