简介基于Python的学生成绩管理系统设计与实现项目是一份适合课程设计、毕业设计或自学练手的完整案例。内容涵盖Python后端逻辑、关系型数据库的表结构设计与增删改查操作并利用Flask/Django类Web框架搭建交互页面可帮助读者理解从需求分析、系统设计到编码测试的软件开发全流程。压缩包共412个文件约12.3MB主要由Python源码、Vue前端组件、SVG图标、JavaScript与CSS等静态资源构成同时附有数据库备份以及安装、运行、构建等批处理脚本便于快速启动和二次开发。目前已有290人学习下载。资料内除了系统前后端代码还包含需求分析、系统设计、数据库设计文档和用户手册配合源码阅读可快速掌握学生信息管理、成绩录入、统计最高/最低分、查询平均分等核心功能的实现思路。对于希望将Python理论用于实际项目、或正在准备软件工程类作业的开发者这份带文档的全套模板具有直接参考价值。1. 学生成绩管理系统一个案例看穿 Python 全栈开发的底层逻辑放在课程设计选题里学生成绩管理系统算得上“经典中的经典”但绝大多数网上的版本只在乎能跑通不在乎设计是否合理。这份基于 Python 的项目表面看是增删改查实际把 JWT 登录态、RESTful API、Vue 组件化页面和自动化部署脚本全部串了起来。对有 Python 基础但没做过完整 Web 项目的人来说它提供了从 model 定义到前端请求链路的完整闭环对工作三五年的开发而言也能从备份文件的命名习惯、分步 bat 脚本里看到工程化意识。适合用它来回答一个实际问题如何把数据库、接口、前端三件事拧成一根能交付的链条。2. 架构与技术选型从 Vue 备份文件看前后端分离的工程化细节2.1 为什么是 Flask Vue而不是 Django 模板渲染这个项目在后端选择了 Flask 而非 Django核心原因是系统规模不大——学生管理涉及的角色就三个管理员、教师、学生接口数量控制在二十个以内。Flask 的轻量特性让每个路由都可见调试时能直接看到请求从 URL 到函数的完整映射比 Django 的 MTV 模式更适合用来理解 Web 框架的本质。同时 Flask 的 ORM 依赖 SQLAlchemy它的 session 机制和查询 API 与 Django ORM 在底层逻辑上高度相似后续切到 Django 的认知成本很低。前端采用 Vue 而不是服务端模板渲染关键动因是响应式交互需求。成绩录入页面要做到“输入学生学号 → 自动带出姓名 → 动态渲染课程列表”如果用 Jinja2 同步刷新每次键盘事件都要回发一次 HTTP 请求体验和效率都跟不上。Vue 的数据双向绑定天然解决这类场景这也解释了为什么项目里同时出现IndexMain.vue和路由层级一一对应的组件文件。2.2 Vue 组件结构与路由映射资源里的IndexMain.vue、IndexAsideStatic.vue、IndexHeader.vue、BreadCrumbs.vue对应的是后台管理系统的标准布局。各组件职责如下组件文件职责挂载位置IndexMain.vue主内容区容器承载router-view路由页面出口IndexAsideStatic.vue侧边栏静态菜单绑定路由 path左侧导航IndexHeader.vue顶栏含用户下拉菜单与退出按钮顶部通栏BreadCrumbs.vue面包屑导航联动route.meta.title内容区上方侧边栏是高复用模块常见做法是把菜单项声明成一个数组再通过el-menu的router属性开启路由模式使index值直接成为跳转目标!-- IndexAsideStatic.vue 核心结构 -- template el-menu :default-active$route.path router el-menu-item index/dashboard数据看板/el-menu-item el-submenu indexstudent template #title学生管理/template el-menu-item index/student/list学生列表/el-menu-item el-menu-item index/student/add新增学生/el-menu-item /el-submenu el-menu-item index/score/list成绩管理/el-menu-item el-menu-item index/course/list课程管理/el-menu-item /el-menu /template script export default { name: IndexAsideStatic } /script这里:default-active$route.path的作用是让菜单高亮始终跟随当前地址刷新页面后高亮不会丢失。如果写成静态字符串/dashboard那么停留在成绩管理页时刷新侧边栏会错误地高亮到数据看板。遇到“菜单点不动”的情况检查el-menu上是否加了router属性没有加的话index只作为菜单标识不会触发路由跳转。IndexMain.vue里只有一个router-view /它的重点不在模板而在路由配置中为每个页面设置meta.title供BreadCrumbs.vue读取。组件之间的通信统一走 Vuex学生列表页修改了一条数据后触发commit更新store.state.students列表组件通过mapState拿到最新数据计算属性响应式驱动视图刷新。2.3 备份文件的工程含义资源里那一批.bak后缀文件update-password.vue.bak、IndexHeader.vue.bak等不是冗余垃圾而是开发过程的历史快照。.bak文件保留了两类信息一是源码在某个稳定版本时的状态二是改动前后可对比的 diff 基线。比如update-password.vue.bak通常是密码修改功能加了“短信验证码”或“强制首次登录改密”之前的稳定版本出问题时可以直接用copy命令回滚。这套东西之所以用.bak而不是 Git 分支大概率是项目初期没有初始化版本仓库。这里给一个可复用的补救做法拿到这类带.bak的工程后先把它们纳入.gitignore再对主力代码创建 Git 基线之后.bak文件就是从旁参照的“野生注释”。注意update-password.vue.bak和update-password.vue并存时要对比两文件的更新时间戳判断哪一个才是新版本。3. 数据库模型设计三张核心表的外键约束与聚合查询3.1 学生、课程、成绩三张表的字段规划成绩管理系统的数据模型不复杂但字段类型选错后面全是坑。学生的学号建议用VARCHAR(20)而不是INT原因有两个学号含前导零时整型会丢失格式学号未来可能混入字母后缀比如转专业重编。课程表的学分用DECIMAL(3,1)避免浮点比较误差。成绩表的设计是关键要加唯一约束防止同一位学生在同一门课程被重复录分CREATE TABLE student ( student_id VARCHAR(20) PRIMARY KEY, name VARCHAR(50) NOT NULL, gender CHAR(1) CHECK (gender IN (M, F)), class_name VARCHAR(50), enroll_date DATE, status TINYINT DEFAULT 1 COMMENT 1-在读 0-离校 ); CREATE TABLE course ( course_id INT AUTO_INCREMENT PRIMARY KEY, course_name VARCHAR(100) NOT NULL, credit DECIMAL(3,1), teacher_name VARCHAR(50) ); CREATE TABLE score ( id INT AUTO_INCREMENT PRIMARY KEY, student_id VARCHAR(20) NOT NULL, course_id INT NOT NULL, score DECIMAL(5,2) COMMENT 0-100 或 NULL 表示缺考, exam_date DATE, UNIQUE KEY uk_student_course (student_id, course_id), FOREIGN KEY (student_id) REFERENCES student(student_id), FOREIGN KEY (course_id) REFERENCES course(course_id) );三个字段类型的细节值得展开。status用TINYINT而不是BOOL因为学生状态不只是“在读/离校”后续可能扩到“休学”和“毕业”整数枚举的扩展性更好。DECIMAL(5,2)允许最大 999.99成绩场景下完全够用同时避免了FLOAT在WHERE score 89.5时因二进制表示误差匹配失败的问题。唯一键uk_student_course的意义在于即使后端接口没有做重复提交校验数据库层也能挡住同一学生同一课程的重复成绩记录。外键约束在项目初期建议保留。虽然它会影响插入性能但学生成绩管理系统的数据量级在十万行以下性能损失可以忽略而外键带来的数据完整性收益是实打实的——没有它的保护删除一门课程时会留下大量“成绩记录对应不到课程”的脏数据。3.2 成绩聚合查询SQL 与 ORM 双写对照统计每门课程的平均分、最高分、最低分和参考人数是这个系统最核心的报表需求。SQL 写法如下SELECT c.course_name, ROUND(AVG(s.score), 2) AS avg_score, MAX(s.score) AS max_score, MIN(s.score) AS min_score, COUNT(s.student_id) AS student_count, SUM(CASE WHEN s.score 60 THEN 1 ELSE 0 END) AS fail_count FROM score s JOIN course c ON s.course_id c.course_id WHERE s.score IS NOT NULL GROUP BY c.course_id, c.course_name ORDER BY avg_score DESC;ROUND(AVG(s.score), 2)保留两位小数防止报表出现无限小数WHERE s.score IS NOT NULL把缺考的考生排除在平均分计算之外这是产品层面的决策——缺考记为 0 分还是不计入统计两种口径要先和需求方对齐。SUM(CASE WHEN ...)是条件聚合的标准写法比在 Python 里取回全部成绩再逐个数要高效得多。如果后端用的 SQLAlchemy等价写法是from sqlalchemy import func, case def get_course_score_stats(session): stats ( session.query( Course.course_name, func.round(func.avg(Score.score), 2).label(avg_score), func.max(Score.score).label(max_score), func.min(Score.score).label(min_score), func.count(Score.student_id).label(student_count), func.sum(case((Score.score 60, 1), else_0)).label(fail_count) ) .join(Score, Score.course_id Course.course_id) .filter(Score.score.isnot(None)) .group_by(Course.course_id, Course.course_name) .order_by(func.avg(Score.score).desc()) .all() ) return stats注意func.sum(case((Score.score 60, 1), else_0))的传参方式SQLAlchemy 1.4 之后case的写法从字典形式改为显式when形式旧代码迁移时容易在这里报CompileError。另外聚合查询里group_by的字段必须和select里的非聚合列一致否则 MySQL 在ONLY_FULL_GROUP_BY模式下直接抛ER_WRONG_FIELD_WITH_GROUP错误。3.3 索引策略与事务隔离成绩分页列表常见的查询条件是WHERE student_id ?或WHERE course_id ? ORDER BY exam_date DESC。主键id自增对这类查询没有帮助所以除了唯一键外还需要补充两个二级索引CREATE INDEX idx_score_student ON score(student_id); CREATE INDEX idx_score_course_date ON score(course_id, exam_date DESC);成绩导入通常是批量操作逐条 INSERT 会带来大量磁盘随机写。常见做法是先把数据解析成列表用executemany一次性写入外层事务再用COMMIT收尾。成绩数据的并发冲突点多在“同一学生同一课程的分数被两个终端同时修改”这种情况下事务隔离级别至少要READ COMMITTED写入侧用SELECT ... FOR UPDATE锁住目标成绩行再更新避免出现最终成绩被后写者覆盖的竞态。对 MySQL InnoDB行级锁只在查询命中了索引时才生效这就是上面成绩表建议建立student_id索引的原因之一——全表扫描时行锁会退化为表锁。4. 后端接口实现JWT 登录态、成绩 CRUD 与权限控制4.1 登录接口与双 Token 签发用户表设计时不存明文密码只存password_hash。Flask 下常用werkzeug.security的generate_password_hash和check_password_hash底层是 PBKDF2-SHA256 加盐哈希。登录成功后的核心问题是登录态怎么维护Session 方案需要服务端存储而 JWT 把用户身份和角色信息编码进 Token 本身服务端无状态更适合前后端分离部署。签发时同时返回access_token和refresh_tokenimport jwt from datetime import datetime, timedelta from flask import Flask, request, jsonify from werkzeug.security import check_password_hash ACCESS_EXP timedelta(hours2) REFRESH_EXP timedelta(days7) def generate_tokens(user): access_payload { user_id: user.id, role: user.role, exp: datetime.utcnow() ACCESS_EXP } refresh_payload { user_id: user.id, type: refresh, exp: datetime.utcnow() REFRESH_EXP } return ( jwt.encode(access_payload, app.config[SECRET_KEY], algorithmHS256), jwt.encode(refresh_payload, app.config[SECRET_KEY], algorithmHS256) ) app.route(/api/auth/login, methods[POST]) def login(): data request.get_json() user User.query.filter_by(usernamedata.get(username)).first() if user and check_password_hash(user.password_hash, data.get(password)): access_token, refresh_token generate_tokens(user) return jsonify({access_token: access_token, refresh_token: refresh_token}) return jsonify({msg: 用户名或密码错误}), 401access_token设置 2 小时过期refresh_token设定 7 天是常见的时间配比。过期事件的处理重点在刷新接口收到带type: refresh的 Token 后校验签名和过期时间再签发新的access_token实现无感知续期。如果用户 7 天未操作强制重新登录。这个时间窗口根据业务场景随时可调教务系统通常把有效期放宽到 4 小时财务类系统则建议缩到 30 分钟。4.2 成绩写入接口与装饰器权限控制添加成绩接口要同时校验三件事学生存在、课程存在、成绩范围合法。用装饰器统一做角色校验from functools import wraps import jwt as pyjwt def role_required(allowed_roles): def decorator(fn): wraps(fn) def wrapper(*args, **kwargs): auth_header request.headers.get(Authorization, ) if not auth_header.startswith(Bearer ): return jsonify({msg: 未携带身份凭证}), 401 try: payload pyjwt.decode( auth_header.split( )[1], app.config[SECRET_KEY], algorithms[HS256] ) except pyjwt.ExpiredSignatureError: return jsonify({msg: 登录已过期}), 401 except pyjwt.InvalidTokenError: return jsonify({msg: 非法凭证}), 401 if payload.get(role) not in allowed_roles: return jsonify({msg: 权限不足}), 403 request.user_id payload.get(user_id) return fn(*args, **kwargs) return wrapper return decorator app.route(/api/score, methods[POST]) role_required([admin, teacher]) def add_score(): data request.get_json() student Student.query.get(data.get(student_id)) course Course.query.get(data.get(course_id)) if not student or not course: return jsonify({msg: 学生或课程不存在}), 404 if not (0 float(data.get(score)) 100): return jsonify({msg: 成绩必须在 0-100 之间}), 400 score Score( student_iddata[student_id], course_iddata[course_id], scoredata.get(score) ) db.session.add(score) db.session.commit() return jsonify({msg: 录入成功, id: score.id}), 201role_required返回 401 还是 403 要分清楚Token 缺失或无效是 401身份有效但角色不在白名单是 403。前端 axios 拦截器要根据这两个状态码走不同的分支。从数据库层兜底来看即使接口漏判了重复录入前面的uk_student_course唯一约束也会让commit时报IntegrityError此时要捕获并回滚事务不能把 500 直接抛给前端。4.3 axios 拦截器与 Token 续期流程前端所有请求统一走一个 axios 实例请求拦截器注入 Token响应拦截器处理 401 自动续期import axios from axios const service axios.create({ baseURL: /api, timeout: 10000 }) service.interceptors.request.use(config { const token localStorage.getItem(access_token) if (token) { config.headers.Authorization Bearer ${token} } return config }) service.interceptors.response.use( response response.data, error { const { response, config } error if (response response.status 401) { const refreshToken localStorage.getItem(refresh_token) if (refreshToken response.data.msg ! refresh_token 已过期) { return service.post(/auth/refresh, null, { headers: { Authorization: Bearer ${refreshToken} } }).then(res { localStorage.setItem(access_token, res.access_token) config.headers.Authorization Bearer ${res.access_token} return service(config) }) } localStorage.clear() window.location.href /login } return Promise.reject(error) } )这段代码里有一个容易写错的细节续期后的重发是return service(config)拿到的config是error.config的引用必须显式更新headers.Authorization否则重发时请求拦截器读到的 Token 还是旧的。另一个值得注意的是刷新接口与普通接口共用了同一个 axios 实例“刷新请求本身返回 401”要单独判断否则会出现无限循环调用。5. 一键部署与排错bat 脚本解读与 .bak 文件回滚技巧资源里的安装与启动脚本把部署流程压缩成了三次点击。1-install.bat先执行pip install -r requirements.txt再进前端目录跑npm install安装顺序不能反——后端依赖失败时前端安装纯属浪费时间。2-run.bat启动开发环境时同时拉起 Flask 后端和 Vue dev server注意 Flask 监听端口要避开 8080常见约定是 5000并在前端vue.config.js里配置 devServer 代理把/api前缀转发到后端这样前端请求地址不用写死 IP。3-build.bat执行npm run build把 Vue 编译成静态文件生产环境下由 Flask 路由把根路径指向dist/index.html。遇到端口被占用导致启动失败时依次检查netstat -ano | findstr 5000输出的 PID 是否为残余的 Python 进程杀干净后重启。.bak文件回滚用一行命令恢复copy /Y update-password.vue.bak update-password.vue在.bak文件混乱、不确定哪份是最新版本时先比对修改时间再覆盖。页面白屏排查从 F12 Console 的报错看起——最常见的三类是 Vue 组件名拼写不一致、路由路径与菜单 index 不匹配、后端接口返回了 HTML 而不是 JSON通常是 Flask 路由没匹配上走了 404 模板。最后验证系统是否交付完整用管理员账号登录切换教师和学生角色查看菜单权限差异分别测试成绩录入、编辑、数据看板三个核心流程再回数据库手动删一条成绩记录判断前端是否有空状态处理这一步能省掉交付后一半的答疑时间。本文还有配套的精品资源点击获取
简介基于Python的学生成绩管理系统设计与实现项目是一份适合课程设计、毕业设计或自学练手的完整案例。内容涵盖Python后端逻辑、关系型数据库的表结构设计与增删改查操作并利用Flask/Django类Web框架搭建交互页面可帮助读者理解从需求分析、系统设计到编码测试的软件开发全流程。压缩包共412个文件约12.3MB主要由Python源码、Vue前端组件、SVG图标、JavaScript与CSS等静态资源构成同时附有数据库备份以及安装、运行、构建等批处理脚本便于快速启动和二次开发。目前已有290人学习下载。资料内除了系统前后端代码还包含需求分析、系统设计、数据库设计文档和用户手册配合源码阅读可快速掌握学生信息管理、成绩录入、统计最高/最低分、查询平均分等核心功能的实现思路。对于希望将Python理论用于实际项目、或正在准备软件工程类作业的开发者这份带文档的全套模板具有直接参考价值。1. 学生成绩管理系统一个案例看穿 Python 全栈开发的底层逻辑放在课程设计选题里学生成绩管理系统算得上“经典中的经典”但绝大多数网上的版本只在乎能跑通不在乎设计是否合理。这份基于 Python 的项目表面看是增删改查实际把 JWT 登录态、RESTful API、Vue 组件化页面和自动化部署脚本全部串了起来。对有 Python 基础但没做过完整 Web 项目的人来说它提供了从 model 定义到前端请求链路的完整闭环对工作三五年的开发而言也能从备份文件的命名习惯、分步 bat 脚本里看到工程化意识。适合用它来回答一个实际问题如何把数据库、接口、前端三件事拧成一根能交付的链条。2. 架构与技术选型从 Vue 备份文件看前后端分离的工程化细节2.1 为什么是 Flask Vue而不是 Django 模板渲染这个项目在后端选择了 Flask 而非 Django核心原因是系统规模不大——学生管理涉及的角色就三个管理员、教师、学生接口数量控制在二十个以内。Flask 的轻量特性让每个路由都可见调试时能直接看到请求从 URL 到函数的完整映射比 Django 的 MTV 模式更适合用来理解 Web 框架的本质。同时 Flask 的 ORM 依赖 SQLAlchemy它的 session 机制和查询 API 与 Django ORM 在底层逻辑上高度相似后续切到 Django 的认知成本很低。前端采用 Vue 而不是服务端模板渲染关键动因是响应式交互需求。成绩录入页面要做到“输入学生学号 → 自动带出姓名 → 动态渲染课程列表”如果用 Jinja2 同步刷新每次键盘事件都要回发一次 HTTP 请求体验和效率都跟不上。Vue 的数据双向绑定天然解决这类场景这也解释了为什么项目里同时出现IndexMain.vue和路由层级一一对应的组件文件。2.2 Vue 组件结构与路由映射资源里的IndexMain.vue、IndexAsideStatic.vue、IndexHeader.vue、BreadCrumbs.vue对应的是后台管理系统的标准布局。各组件职责如下组件文件职责挂载位置IndexMain.vue主内容区容器承载router-view路由页面出口IndexAsideStatic.vue侧边栏静态菜单绑定路由 path左侧导航IndexHeader.vue顶栏含用户下拉菜单与退出按钮顶部通栏BreadCrumbs.vue面包屑导航联动route.meta.title内容区上方侧边栏是高复用模块常见做法是把菜单项声明成一个数组再通过el-menu的router属性开启路由模式使index值直接成为跳转目标!-- IndexAsideStatic.vue 核心结构 -- template el-menu :default-active$route.path router el-menu-item index/dashboard数据看板/el-menu-item el-submenu indexstudent template #title学生管理/template el-menu-item index/student/list学生列表/el-menu-item el-menu-item index/student/add新增学生/el-menu-item /el-submenu el-menu-item index/score/list成绩管理/el-menu-item el-menu-item index/course/list课程管理/el-menu-item /el-menu /template script export default { name: IndexAsideStatic } /script这里:default-active$route.path的作用是让菜单高亮始终跟随当前地址刷新页面后高亮不会丢失。如果写成静态字符串/dashboard那么停留在成绩管理页时刷新侧边栏会错误地高亮到数据看板。遇到“菜单点不动”的情况检查el-menu上是否加了router属性没有加的话index只作为菜单标识不会触发路由跳转。IndexMain.vue里只有一个router-view /它的重点不在模板而在路由配置中为每个页面设置meta.title供BreadCrumbs.vue读取。组件之间的通信统一走 Vuex学生列表页修改了一条数据后触发commit更新store.state.students列表组件通过mapState拿到最新数据计算属性响应式驱动视图刷新。2.3 备份文件的工程含义资源里那一批.bak后缀文件update-password.vue.bak、IndexHeader.vue.bak等不是冗余垃圾而是开发过程的历史快照。.bak文件保留了两类信息一是源码在某个稳定版本时的状态二是改动前后可对比的 diff 基线。比如update-password.vue.bak通常是密码修改功能加了“短信验证码”或“强制首次登录改密”之前的稳定版本出问题时可以直接用copy命令回滚。这套东西之所以用.bak而不是 Git 分支大概率是项目初期没有初始化版本仓库。这里给一个可复用的补救做法拿到这类带.bak的工程后先把它们纳入.gitignore再对主力代码创建 Git 基线之后.bak文件就是从旁参照的“野生注释”。注意update-password.vue.bak和update-password.vue并存时要对比两文件的更新时间戳判断哪一个才是新版本。3. 数据库模型设计三张核心表的外键约束与聚合查询3.1 学生、课程、成绩三张表的字段规划成绩管理系统的数据模型不复杂但字段类型选错后面全是坑。学生的学号建议用VARCHAR(20)而不是INT原因有两个学号含前导零时整型会丢失格式学号未来可能混入字母后缀比如转专业重编。课程表的学分用DECIMAL(3,1)避免浮点比较误差。成绩表的设计是关键要加唯一约束防止同一位学生在同一门课程被重复录分CREATE TABLE student ( student_id VARCHAR(20) PRIMARY KEY, name VARCHAR(50) NOT NULL, gender CHAR(1) CHECK (gender IN (M, F)), class_name VARCHAR(50), enroll_date DATE, status TINYINT DEFAULT 1 COMMENT 1-在读 0-离校 ); CREATE TABLE course ( course_id INT AUTO_INCREMENT PRIMARY KEY, course_name VARCHAR(100) NOT NULL, credit DECIMAL(3,1), teacher_name VARCHAR(50) ); CREATE TABLE score ( id INT AUTO_INCREMENT PRIMARY KEY, student_id VARCHAR(20) NOT NULL, course_id INT NOT NULL, score DECIMAL(5,2) COMMENT 0-100 或 NULL 表示缺考, exam_date DATE, UNIQUE KEY uk_student_course (student_id, course_id), FOREIGN KEY (student_id) REFERENCES student(student_id), FOREIGN KEY (course_id) REFERENCES course(course_id) );三个字段类型的细节值得展开。status用TINYINT而不是BOOL因为学生状态不只是“在读/离校”后续可能扩到“休学”和“毕业”整数枚举的扩展性更好。DECIMAL(5,2)允许最大 999.99成绩场景下完全够用同时避免了FLOAT在WHERE score 89.5时因二进制表示误差匹配失败的问题。唯一键uk_student_course的意义在于即使后端接口没有做重复提交校验数据库层也能挡住同一学生同一课程的重复成绩记录。外键约束在项目初期建议保留。虽然它会影响插入性能但学生成绩管理系统的数据量级在十万行以下性能损失可以忽略而外键带来的数据完整性收益是实打实的——没有它的保护删除一门课程时会留下大量“成绩记录对应不到课程”的脏数据。3.2 成绩聚合查询SQL 与 ORM 双写对照统计每门课程的平均分、最高分、最低分和参考人数是这个系统最核心的报表需求。SQL 写法如下SELECT c.course_name, ROUND(AVG(s.score), 2) AS avg_score, MAX(s.score) AS max_score, MIN(s.score) AS min_score, COUNT(s.student_id) AS student_count, SUM(CASE WHEN s.score 60 THEN 1 ELSE 0 END) AS fail_count FROM score s JOIN course c ON s.course_id c.course_id WHERE s.score IS NOT NULL GROUP BY c.course_id, c.course_name ORDER BY avg_score DESC;ROUND(AVG(s.score), 2)保留两位小数防止报表出现无限小数WHERE s.score IS NOT NULL把缺考的考生排除在平均分计算之外这是产品层面的决策——缺考记为 0 分还是不计入统计两种口径要先和需求方对齐。SUM(CASE WHEN ...)是条件聚合的标准写法比在 Python 里取回全部成绩再逐个数要高效得多。如果后端用的 SQLAlchemy等价写法是from sqlalchemy import func, case def get_course_score_stats(session): stats ( session.query( Course.course_name, func.round(func.avg(Score.score), 2).label(avg_score), func.max(Score.score).label(max_score), func.min(Score.score).label(min_score), func.count(Score.student_id).label(student_count), func.sum(case((Score.score 60, 1), else_0)).label(fail_count) ) .join(Score, Score.course_id Course.course_id) .filter(Score.score.isnot(None)) .group_by(Course.course_id, Course.course_name) .order_by(func.avg(Score.score).desc()) .all() ) return stats注意func.sum(case((Score.score 60, 1), else_0))的传参方式SQLAlchemy 1.4 之后case的写法从字典形式改为显式when形式旧代码迁移时容易在这里报CompileError。另外聚合查询里group_by的字段必须和select里的非聚合列一致否则 MySQL 在ONLY_FULL_GROUP_BY模式下直接抛ER_WRONG_FIELD_WITH_GROUP错误。3.3 索引策略与事务隔离成绩分页列表常见的查询条件是WHERE student_id ?或WHERE course_id ? ORDER BY exam_date DESC。主键id自增对这类查询没有帮助所以除了唯一键外还需要补充两个二级索引CREATE INDEX idx_score_student ON score(student_id); CREATE INDEX idx_score_course_date ON score(course_id, exam_date DESC);成绩导入通常是批量操作逐条 INSERT 会带来大量磁盘随机写。常见做法是先把数据解析成列表用executemany一次性写入外层事务再用COMMIT收尾。成绩数据的并发冲突点多在“同一学生同一课程的分数被两个终端同时修改”这种情况下事务隔离级别至少要READ COMMITTED写入侧用SELECT ... FOR UPDATE锁住目标成绩行再更新避免出现最终成绩被后写者覆盖的竞态。对 MySQL InnoDB行级锁只在查询命中了索引时才生效这就是上面成绩表建议建立student_id索引的原因之一——全表扫描时行锁会退化为表锁。4. 后端接口实现JWT 登录态、成绩 CRUD 与权限控制4.1 登录接口与双 Token 签发用户表设计时不存明文密码只存password_hash。Flask 下常用werkzeug.security的generate_password_hash和check_password_hash底层是 PBKDF2-SHA256 加盐哈希。登录成功后的核心问题是登录态怎么维护Session 方案需要服务端存储而 JWT 把用户身份和角色信息编码进 Token 本身服务端无状态更适合前后端分离部署。签发时同时返回access_token和refresh_tokenimport jwt from datetime import datetime, timedelta from flask import Flask, request, jsonify from werkzeug.security import check_password_hash ACCESS_EXP timedelta(hours2) REFRESH_EXP timedelta(days7) def generate_tokens(user): access_payload { user_id: user.id, role: user.role, exp: datetime.utcnow() ACCESS_EXP } refresh_payload { user_id: user.id, type: refresh, exp: datetime.utcnow() REFRESH_EXP } return ( jwt.encode(access_payload, app.config[SECRET_KEY], algorithmHS256), jwt.encode(refresh_payload, app.config[SECRET_KEY], algorithmHS256) ) app.route(/api/auth/login, methods[POST]) def login(): data request.get_json() user User.query.filter_by(usernamedata.get(username)).first() if user and check_password_hash(user.password_hash, data.get(password)): access_token, refresh_token generate_tokens(user) return jsonify({access_token: access_token, refresh_token: refresh_token}) return jsonify({msg: 用户名或密码错误}), 401access_token设置 2 小时过期refresh_token设定 7 天是常见的时间配比。过期事件的处理重点在刷新接口收到带type: refresh的 Token 后校验签名和过期时间再签发新的access_token实现无感知续期。如果用户 7 天未操作强制重新登录。这个时间窗口根据业务场景随时可调教务系统通常把有效期放宽到 4 小时财务类系统则建议缩到 30 分钟。4.2 成绩写入接口与装饰器权限控制添加成绩接口要同时校验三件事学生存在、课程存在、成绩范围合法。用装饰器统一做角色校验from functools import wraps import jwt as pyjwt def role_required(allowed_roles): def decorator(fn): wraps(fn) def wrapper(*args, **kwargs): auth_header request.headers.get(Authorization, ) if not auth_header.startswith(Bearer ): return jsonify({msg: 未携带身份凭证}), 401 try: payload pyjwt.decode( auth_header.split( )[1], app.config[SECRET_KEY], algorithms[HS256] ) except pyjwt.ExpiredSignatureError: return jsonify({msg: 登录已过期}), 401 except pyjwt.InvalidTokenError: return jsonify({msg: 非法凭证}), 401 if payload.get(role) not in allowed_roles: return jsonify({msg: 权限不足}), 403 request.user_id payload.get(user_id) return fn(*args, **kwargs) return wrapper return decorator app.route(/api/score, methods[POST]) role_required([admin, teacher]) def add_score(): data request.get_json() student Student.query.get(data.get(student_id)) course Course.query.get(data.get(course_id)) if not student or not course: return jsonify({msg: 学生或课程不存在}), 404 if not (0 float(data.get(score)) 100): return jsonify({msg: 成绩必须在 0-100 之间}), 400 score Score( student_iddata[student_id], course_iddata[course_id], scoredata.get(score) ) db.session.add(score) db.session.commit() return jsonify({msg: 录入成功, id: score.id}), 201role_required返回 401 还是 403 要分清楚Token 缺失或无效是 401身份有效但角色不在白名单是 403。前端 axios 拦截器要根据这两个状态码走不同的分支。从数据库层兜底来看即使接口漏判了重复录入前面的uk_student_course唯一约束也会让commit时报IntegrityError此时要捕获并回滚事务不能把 500 直接抛给前端。4.3 axios 拦截器与 Token 续期流程前端所有请求统一走一个 axios 实例请求拦截器注入 Token响应拦截器处理 401 自动续期import axios from axios const service axios.create({ baseURL: /api, timeout: 10000 }) service.interceptors.request.use(config { const token localStorage.getItem(access_token) if (token) { config.headers.Authorization Bearer ${token} } return config }) service.interceptors.response.use( response response.data, error { const { response, config } error if (response response.status 401) { const refreshToken localStorage.getItem(refresh_token) if (refreshToken response.data.msg ! refresh_token 已过期) { return service.post(/auth/refresh, null, { headers: { Authorization: Bearer ${refreshToken} } }).then(res { localStorage.setItem(access_token, res.access_token) config.headers.Authorization Bearer ${res.access_token} return service(config) }) } localStorage.clear() window.location.href /login } return Promise.reject(error) } )这段代码里有一个容易写错的细节续期后的重发是return service(config)拿到的config是error.config的引用必须显式更新headers.Authorization否则重发时请求拦截器读到的 Token 还是旧的。另一个值得注意的是刷新接口与普通接口共用了同一个 axios 实例“刷新请求本身返回 401”要单独判断否则会出现无限循环调用。5. 一键部署与排错bat 脚本解读与 .bak 文件回滚技巧资源里的安装与启动脚本把部署流程压缩成了三次点击。1-install.bat先执行pip install -r requirements.txt再进前端目录跑npm install安装顺序不能反——后端依赖失败时前端安装纯属浪费时间。2-run.bat启动开发环境时同时拉起 Flask 后端和 Vue dev server注意 Flask 监听端口要避开 8080常见约定是 5000并在前端vue.config.js里配置 devServer 代理把/api前缀转发到后端这样前端请求地址不用写死 IP。3-build.bat执行npm run build把 Vue 编译成静态文件生产环境下由 Flask 路由把根路径指向dist/index.html。遇到端口被占用导致启动失败时依次检查netstat -ano | findstr 5000输出的 PID 是否为残余的 Python 进程杀干净后重启。.bak文件回滚用一行命令恢复copy /Y update-password.vue.bak update-password.vue在.bak文件混乱、不确定哪份是最新版本时先比对修改时间再覆盖。页面白屏排查从 F12 Console 的报错看起——最常见的三类是 Vue 组件名拼写不一致、路由路径与菜单 index 不匹配、后端接口返回了 HTML 而不是 JSON通常是 Flask 路由没匹配上走了 404 模板。最后验证系统是否交付完整用管理员账号登录切换教师和学生角色查看菜单权限差异分别测试成绩录入、编辑、数据看板三个核心流程再回数据库手动删一条成绩记录判断前端是否有空状态处理这一步能省掉交付后一半的答疑时间。本文还有配套的精品资源点击获取
