学生信息管理系统源码实战：环境搭建、CRUD、权限与小程序联调

简介：《学生信息管理系统》配套程序与源码包，面向学习小型信息管理应用开发的学生、教师及教务管理人员，帮助理解学生信息录入、查询、删除、修改、排序、人数统计与列表展示等完整业务闭环。压缩包共4个文件，涵盖2份doc说明文档、1个exe可执行程序和1个py源码文件，整体约5.96MB，既可运行体验功能，也能对照源码梳理数据库增删改查、条件检索、排序算法与界面交互的实现思路。已有143人学习，适合课程设计、期末项目或Python入门实践时参考。通过使用说明和配置说明可快速了解程序结构与运行方式，源码则便于二次修改和功能扩展，对掌握SQL查询、数据一致性处理及小型管理系统设计有一定帮助。

1. 一套带源码的学生信息管理系统，能替你省掉哪两周

学生信息管理系统源码这类资源，真正的价值不在于“功能多全”，而在于把建表、登录、分页、权限这一批重复劳动提前做完。某高校实训周要求两周交一套能演示增删改查、能按班级筛人、还得配个小程序端扫码查分的系统，从零写代码的人基本都卡在第三天——不是不会写业务，是环境、依赖、编码、跨域这些杂事把时间吃光了。这套源码的定位就是：骨架已经搭好，你只改字段和页面。

适合三类人：赶课程设计的学生、接小项目需要快速出原型的开发者、想拿一个完整 CRUD 工程练后端分层的人。不适合谁？想找高并发、分布式范例的人。这类项目的目标是“够用、能演示、改得动”，把它当脚手架用，别当架构教科书看。

2. 开箱先摸骨架：目录、依赖清单与三张核心表

拿到压缩包，第一件事不是双击运行，是先把目录摊开看一遍。带源码的课程设计类项目，十个里有八个死在“不知道该改哪个文件”上。摸着骨架走一遍，后面每一步都能对上号。

2.1 目录结构里藏着三个入口

常见的分包方式大致长这样，不同作者命名有差异，但层次基本一致：

student-info/ ├── doc/ # 部署说明、ER 图、答辩用的功能清单 ├── sql/ │ ├── schema.sql # 建表语句 │ └── data.sql # 初始数据：管理员账号、班级与课程字典 ├── si-backend/ # 后端服务 │ ├── pom.xml │ └── src/main/ │ ├── java/... # controller / service / mapper / entity │ └── resources/ │ ├── application.yml │ └── mapper/ # MyBatis XML（部分版本用注解，没有这层） ├── si-web/ # PC 端前端 │ ├── package.json │ ├── vite.config.js # 或 vue.config.js，代理配置在这 │ └── src/ │ ├── api/ # 接口封装 │ ├── router/ # 路由与菜单 │ └── views/ # 页面 └── si-miniapp/ # 小程序端（部分版本有，部分没有） └── pages/

三个入口按这个顺序找：pom.xml或package.json决定依赖能不能装上；src/main/resources/application.yml决定连哪个库；vite.config.js里的proxy决定前端请求打到哪个端口。这三个文件读完，整套系统怎么跑起来心里就有数了。

提示：如果目录里同时存在si-web和web、或者两个application.yml（一个在 resources 根下，一个在config/子目录），说明这份源码被多人改过并合并过。Spring Boot 的配置加载有优先级，config/目录下的会覆盖根目录，改配置前先确认改的是生效的那一份，否则会出现“明明改了端口却没变化”的玄学现象。

2.2 依赖清单先核对，别急着装环境

打开pom.xml和package.json，把关键依赖抄成一张表再动手。这一步花五分钟，能省掉后面两小时的报错排查。

依赖清单里如果同时出现log4j和slf4j、或者两个 JSON 库，先别清理，那是历史遗留，删了可能编译不过。血泪经验：动依赖之前先mvn dependency:tree打一份快照，出了问题能回滚。

# 输出依赖树，重定向到文件方便对比 mvn -q dependency:tree -DoutputFile=deps-before.txt

-DoutputFile把结果写到文件里，比在控制台翻屏靠谱。改造前后各跑一次，diff 一下就知道哪条依赖被顶掉了。

2.3 三张核心表撑起八成功能

不管界面做得多花，学生信息管理系统的数据模型基本绕不开三张表：学生、成绩、账号角色。sql/schema.sql里通常还有班级表、课程表，但真正影响你改代码的是这三张。

CREATE TABLE student ( id BIGINT PRIMARY KEY AUTO_INCREMENT, sno VARCHAR(20) NOT NULL COMMENT '学号，业务主键', name VARCHAR(50) NOT NULL COMMENT '姓名', gender TINYINT DEFAULT 0 COMMENT '0未知 1男 2女', class_id BIGINT NOT NULL COMMENT '班级外键', phone VARCHAR(20) DEFAULT NULL, status TINYINT DEFAULT 1 COMMENT '1在读 0离校', deleted TINYINT DEFAULT 0 COMMENT '软删除标记', UNIQUE KEY uk_sno (sno), KEY idx_class (class_id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE score ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_id BIGINT NOT NULL, course_id BIGINT NOT NULL, term VARCHAR(20) NOT NULL COMMENT '学期，如 2024-2025-1', score DECIMAL(5,2) DEFAULT NULL, UNIQUE KEY uk_stu_course_term (student_id, course_id, term), KEY idx_student (student_id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE sys_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL, password VARCHAR(100) NOT NULL COMMENT '密文，不是明文', role VARCHAR(20) NOT NULL COMMENT 'ADMIN / TEACHER / STUDENT', UNIQUE KEY uk_username (username) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

逻辑说明：sno上加唯一索引，是防止重复录入学号的最后一道防线，代码里的查重只是体验优化；uk_stu_course_term保证同一个人同一门课同一学期只有一条成绩记录，这个约束决定了后面成绩录入能不能用“先删后插”的写法；deleted软删除字段决定了你所有查询都要带deleted = 0，漏一处就会把退学的学生查出来。

参数说明：utf8mb4而不是utf8，因为后者在 MySQL 里是三个字节的残废版本，存不了 emoji 也存不了部分生僻字，学生姓名里有生僻字就会插入失败；DECIMAL(5,2)而不是FLOAT，成绩要参与计算和排序，浮点误差会让你排名次时出现两个 89.9999。这些都是小地方，但答辩现场被问一句“为什么用这个类型”答不上来就很难看。

3. 从空库到能登录：环境对齐、脚本导入与四行配置

这一步的目标很明确：浏览器能打开登录页，输账号密码能进主页。所有报错都在这条主线上解决。

3.1 环境清单先对齐，别让版本打架

把要装的东西列成清单，一项一项打勾：

最关键的一条：mvn -v输出的 Java version 必须和java -version一致。很多人机器上装了两个 JDK，命令行里是 8，IDEA 里配的是 17，然后一边编译过一边编译不过，来回折腾半天。环境变量JAVA_HOME指向哪个，mvn就用哪个。

注意：如果 pom 里写的是 Spring Boot 3.x，那 JDK 必须是 17 以上，降版本是降不下去的。反过来如果 pom 是 2.x 而本机只有 17，通常在 2.7 之后也能跑，但更稳妥的做法是装一个 JDK 8 用JAVA_HOME切换，别去改 pom 里的版本号。

3.2 建库与导入脚本

先建库，再导结构，最后灌初始数据。顺序不能反，data.sql里往往有外键引用。

# 1. 建库，字符集一次到位 mysql -uroot -p -e "CREATE DATABASE si_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;" # 2. 导入表结构 mysql -uroot -p si_db < sql/schema.sql # 3. 导入初始数据（管理员账号、班级字典） mysql -uroot -p si_db < sql/data.sql # 4. 验证：三张表的数据量 mysql -uroot -p -e "SELECT (SELECT COUNT(*) FROM si_db.student) AS stu, (SELECT COUNT(*) FROM si_db.sys_user) AS usr;"

逻辑说明：第 1 步把字符集和排序规则一次性定死，后面建表不写DEFAULT CHARSET也会继承库的设置；第 2、3 步用重定向而不是source，是因为在脚本里source的路径解析依赖当前工作目录，容易翻车；第 4 步用一条 SQL 查两个计数，比分别use再查快。

参数说明：utf8mb4_general_ci里的ci是大小写不敏感，学号如果区分大小写（有些学校用字母前缀），要换成utf8mb4_bin。这个选择在建库那一刻就定了，后面改要重建表，代价很大。

导入完先别急，打开data.sql看一眼管理员密码那一行。如果是e10adc3949ba59abbe56e057f20f883e这种 32 位字符串，那是 MD5；如果是$2a$10$开头，那是 BCrypt。记下来，登录失败时要用。

3.3 配置文件改四行就够

打开application.yml，真正需要你动的只有四处：端口、库名、账号、密码。其余先别碰。

server: port: 8080 servlet: context-path: /api # 前端代理要跟这里对上 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/si_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true&useSSL=false username: root password: ${DB_PASSWORD:123456} mybatis-plus: mapper-locations: classpath*:/mapper/**/*.xml configuration: map-underscore-to-camel-case: true

逻辑说明：driver-class-name用com.mysql.cj.jdbc.Driver对应 MySQL 8 的驱动，5.x 时代是com.mysql.jdbc.Driver，写错会报“找不到驱动”；context-path决定所有接口的前缀，前端代理必须跟着改，这是跨域 404 的头号元凶；map-underscore-to-camel-case打开后，数据库的class_id才能自动映射到实体的classId，关掉就得手写 resultMap。

参数说明：serverTimezone=Asia/Shanghai不写会出现时间差 8 小时，成绩录入时间、创建时间全都不对；allowPublicKeyRetrieval=true是 MySQL 8 默认加密方式下必须加的，不加会报公钥检索失败；useSSL=false本地开发关掉，省掉证书告警；密码写成${DB_PASSWORD:123456}是占位符形式，冒号后面是默认值，正式环境用环境变量覆盖，别把密码提交到仓库。

3.4 启动顺序与首次登录验证

后端先起，前端后起，顺序反了前端会一直转圈。

# 后端：打包并运行 cd si-backend mvn clean package -DskipTests java -jar target/si-backend-0.0.1-SNAPSHOT.jar --spring.profiles.active=dev # 另开一个终端，前端 cd si-web npm install --registry=https://registry.npmmirror.com npm run dev

-DskipTests跳过测试，因为课程设计类项目的测试用例经常是半成品，跑起来反而卡住；--spring.profiles.active=dev指定配置文件后缀，如果项目只有application.yml没有-dev版本，把这个参数去掉，否则会找不到配置。前端--registry临时指定镜像源，不写进全局配置，避免影响其他项目。

登录验证按顺序走三步，出问题能立刻定位在哪一层：先直接请求登录接口，看返回体里有没有 token；再拿 token 请求一次列表接口，看是不是 200；最后才打开前端页面看菜单渲染。

# 1. 登录拿 token curl -s -X POST http://127.0.0.1:8080/api/auth/login \ -H "Content-Type: application/json" \ -d '{"username":"admin","password":"123456"}' # 2. 带 token 请求学生列表 curl -s "http://127.0.0.1:8080/api/student/page?pageNum=1&pageSize=10" \ -H "Authorization: Bearer <上一步返回的token>"

接口通了页面打不开，问题在前端；接口 401，问题在账号密码或 token 解析；接口 404，检查context-path和前端代理是否一致。这三步走完，能省掉大量“页面白屏但不知道哪错了”的时间。

4. 改业务的三个落点：分页查询、成绩事务与权限菜单

系统能跑只是起点，真正花时间的是往里塞自己的业务。学生信息管理系统里改得最多的三处：列表分页查询、成绩批量录入、权限菜单配置。这三处各有各的坑。

4.1 学生档案的分页与条件查询

列表页是最先被改的，因为每个学校要筛的字段都不一样。核心在分页对象和条件构造器。

@GetMapping("/page") public Result<PageResult<StudentVO>> page(StudentQuery query) { // pageNum 从 1 开始，不是 0 Page<Student> page = new Page<>(query.getPageNum(), query.getPageSize()); LambdaQueryWrapper<Student> wrapper = Wrappers.lambdaQuery(); wrapper.like(StringUtils.hasText(query.getName()), Student::getName, query.getName()) .eq(StringUtils.hasText(query.getSno()), Student::getSno, query.getSno()) .eq(query.getClassId() != null, Student::getClassId, query.getClassId()) .eq(Student::getDeleted, 0) // 软删除必须带 .orderByDesc(Student::getId); Page<Student> result = studentMapper.selectPage(page, wrapper); return Result.ok(PageResult.of(result, StudentVO::from)); }

逻辑说明：like和eq的第一个参数是布尔条件，只有为 true 才会拼进 SQL。这是 MyBatis-Plus 的条件构造写法，好处是不用写一堆if拼字符串，也不会出现name like '%null%'这种查不到数据的怪现象。StudentVO::from做实体到视图对象的转换，别直接把实体返回给前端——实体里可能有password、deleted这类不该暴露的字段。

参数说明：pageNum在 MyBatis-Plus 里从 1 开始，而 PageHelper 也是从 1 开始，但有些手写分页的工具类从 0 开始，混用就会出现“第一页数据是空的”。pageSize一定要在后端设上限，常见做法是Math.min(size, 100)，否则前端传个 100000 直接把内存打满。orderByDesc(Student::getId)而不是按姓名排序，是因为姓名有重复，排序结果不稳定，翻页时会出现同一条记录出现两次。

前端那边对应的是查询表单和表格，字段名要和StudentQuery完全对上，包括大小写。驼峰和下划线混用是最常见的联调问题。

4.2 成绩录入的事务与唯一约束

成绩录入是这套系统里唯一需要认真对待事务的地方，因为它是批量操作，一条失败整批都得回滚。

@Transactional(rollbackFor = Exception.class) public void saveScores(Long courseId, String term, List<ScoreItem> items) { if (CollectionUtils.isEmpty(items)) { return; } // 先按唯一键删一遍，再批量插，避免逐条判断存在性 scoreMapper.delete(Wrappers.<Score>lambdaQuery() .eq(Score::getCourseId, courseId) .eq(Score::getTerm, term) .in(Score::getStudentId, items.stream().map(ScoreItem::getStudentId).toList())); List<Score> list = items.stream() .map(i -> Score.builder() .studentId(i.getStudentId()) .courseId(courseId) .term(term) .score(i.getScore()) .build()) .toList(); scoreMapper.insertBatchSomeColumn(list); // 批量插入，别循环调 insert }

逻辑说明：rollbackFor = Exception.class必须显式写。Spring 默认只在运行时异常时回滚，受检异常不回滚，这个默认值坑过太多人。先删后插的写法依赖数据库的uk_stu_course_term唯一索引兜底，如果两个老师同时录同一门课，后提交的会覆盖前面的，这是业务上可接受的；如果业务不允许覆盖，就得改成先查再插，并在捕获DuplicateKeyException时给出明确提示。

参数说明：insertBatchSomeColumn是 MyBatis-Plus 的扩展方法，需要自己写一个InsertBatchSomeColumn的 Bean 注入，原生insert循环调用会产生 N 次数据库往返，一百条成绩就是一百次网络开销。批量插入的条数建议按 500 一批切分，太大容易触发 MySQL 的max_allowed_packet限制。

注意：改完成绩记得同步刷新统计。很多版本的成绩汇总是一张单独的统计表或者视图，如果只改了明细表没刷新汇总，页面上会出现“明细是 90 分、平均分还是 80”的错位，演示时非常尴尬。常见的做法是在 service 方法末尾发一个刷新事件，或者干脆把汇总改成实时聚合查询。

4.3 权限菜单：前端隐藏不等于后端拦截

菜单和路由的配置决定了不同角色看到什么。典型写法是这样：

// router/index.js const routes = [ { path: '/student', component: () => import('@/views/student/index.vue'), meta: { title: '学生档案', roles: ['ADMIN', 'TEACHER'] } }, { path: '/score/input', component: () => import('@/views/score/input.vue'), meta: { title: '成绩录入', roles: ['ADMIN', 'TEACHER'] } }, { path: '/score/query', component: () => import('@/views/score/query.vue'), meta: { title: '成绩查询', roles: ['ADMIN', 'TEACHER', 'STUDENT'] } } ] router.beforeEach((to, from, next) => { const token = localStorage.getItem('token') const role = localStorage.getItem('role') if (!token && to.path !== '/login') return next('/login') if (to.meta.roles && !to.meta.roles.includes(role)) return next('/403') next() })

逻辑说明：component: () => import(...)是路由懒加载，按路由拆包，首屏只加载登录页，学生档案页在点击时才下载。meta.roles由beforeEach校验，角色存在localStorage里。这段代码只能挡住正常点击菜单的用户，改一下localStorage里的 role 就能绕过去。

参数说明：真正的权限必须在后端接口上做。常见做法是在 Controller 方法上加注解（如@PreAuthorize("hasRole('ADMIN')")）或者在拦截器里按 URL 前缀匹配角色。前端这套只负责体验——不该看的菜单不显示，减少误操作，别指望它做安全边界。

5. 二次开发踩坑记录：五个现象、五个根因

下面五条都是在这类项目上反复出现的，按“现象 → 原因 → 解决”记，遇到时直接对号入座。

5.1 环境与依赖类

坑一：编译报“无效的目标发行版: 17”。现象是mvn package一启动就红字退出，IDEA 里却一切正常。原因是命令行用的 JDK 版本低于 pom 里maven.compiler.source声明的版本，两套 JDK 并存时最常见。解决：先跑mvn -v看 Maven 实际用的 Java 版本，再和java -version对比，不一致就改JAVA_HOME指向正确的 JDK，改完重开终端。别急着去 pom 里降版本，先确认是不是环境问题。

坑二：npm install卡在某个包上，最后报 node-sass 编译失败。现象是安装进度条停住，日志里全是gyp ERR!。原因是node-sass与 Node 版本强绑定，Node 18 装不上老版本的 node-sass。解决：把依赖里的node-sass换成sass（dart-sass 实现，纯 JS 无需编译），同时把代码里的@import语法保持不变即可，绝大多数样式不用改。如果项目必须用 node-sass，那就用.nvmrc锁定 Node 版本，别硬扛。

5.2 数据与编码类

坑三：页面中文全是问号，或者控制台打印出来是乱码。现象是数据库里明明是中文，页面上显示???。原因通常有三处不一致：建库时用了latin1、连接串没写characterEncoding=utf8、Tomcat 的URIEncoding没配。解决：按“库 → 表 → 连接串 → 容器”的顺序统一成 utf8mb4，一处都不能漏。已经有数据的表用ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4转换，转之前先备份。

坑四：登录一直提示密码错误，数据库里明明是 123456。现象是账号密码都抄对了，就是登不进去。原因是sys_user表里的密码存的是密文（MD5 或 BCrypt），初始数据脚本里可能插的是明文，或者用的是另一套盐值。解决：找到项目里的密码加密工具类，用它生成一次密文，直接UPDATE sys_user SET password = '<密文>' WHERE username = 'admin';。临时调试可以把校验逻辑改成明文比对，但改完记得改回来，别把这段提交上去。

5.3 前后端联调类

坑五：前端请求全部 404，偶尔伴随 CORS 报错。现象是浏览器 Network 面板一片红，接口路径看着没错。原因有三个高发点：前端proxy的target端口和后端server.port不一致；后端配了context-path但前端请求没带这个前缀；代理的pathRewrite把/api又重写了一遍导致重复。解决：按“后端实际端口 → context-path → 前端 proxy target → pathRewrite”四步逐项核对，最省事的办法是先用curl直接打后端地址，确认接口本身通不通，再回头查代理。

另一条容易忽略的：分页查出来total是对的但列表为空。八成是 MyBatis-Plus 的分页插件没注册，或者同时引入了 PageHelper 造成两个分页拦截器打架。解决：只保留一个分页方案，MyBatis-Plus 就在配置类里加MybatisPlusInterceptor并注册PaginationInnerInterceptor，把 PageHelper 的依赖和配置清掉。

6. 接一个小程序端：接口复用、字段裁剪与联调验证

PC 端跑通之后，很多人会想加一个小程序端做扫码查分——这也是这类项目最容易被要求加的功能。好消息是：后端接口基本不用改，坏消息是直接复用会带出一堆冗余字段和性能问题。

先做字段裁剪。PC 端的学生列表里可能带了二十几个字段，小程序端一个卡片只显示姓名、学号、班级、总分，其余全是浪费带宽。常见的做法是新建一个精简的 VO，或者在接口上开一个scene参数区分场景：

再封一层请求工具，把 token 注入和错误处理收在一处，页面里只关心数据：

// utils/request.js const BASE_URL = 'http://127.0.0.1:8080/api' export function request({ url, method = 'GET', data = {} }) { return new Promise((resolve, reject) => { uni.request({ url: BASE_URL + url, method, data, header: { 'Content-Type': 'application/json', Authorization: uni.getStorageSync('token') || '' }, success: (res) => { // 后端统一返回 { code, msg, data }，code 为 0 表示成功 if (res.statusCode === 200 && res.data.code === 0) { resolve(res.data.data) } else if (res.statusCode === 401) { uni.removeStorageSync('token') uni.reLaunch({ url: '/pages/login/index' }) reject(new Error('登录已过期')) } else { reject(new Error(res.data.msg || '请求失败')) } }, fail: reject }) }) }

BASE_URL里的/api必须和后端context-path完全一致，这是小程序端最容易出错的地方——小程序没有开发服务器的代理，请求路径是实打实的，写少一段就是 404。401单独处理是因为 token 过期在小程序里很常见，静默跳登录页比弹个错误提示体验好得多。uni.reLaunch而不是navigateTo，是为了清空页面栈，避免用户返回时又回到过期状态。

联调顺序建议反过来：先用浏览器或curl把接口打一遍，确认返回结构和字段名，再写页面。小程序端的调试工具看网络请求不如浏览器直观，先在后端确认没问题，能省掉一半来回。我一般会准备一个curl脚本，把登录、列表、详情三个接口串起来跑一遍，改完后端先跑脚本，脚本绿了再去动前端。

最后一条教训：小程序端的域名必须是备案过的 HTTPS 地址，本地开发时要在开发者工具里勾选“不校验合法域名”，否则127.0.0.1直接请求会被拦。这个开关只在本地有效，上线前一定要把BASE_URL换成正式地址并重新验证一遍——我有一次就是忘了换，本地全绿、真机全红，返工半天。从那以后我每次交付前都强制走一遍“真机 + 正式域名”的冒烟测试，不管多赶都跑。希望帮到你。

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