基于Flask+MySQL的教务管理系统：毕设实战指南

简介基于PythonFlaskMySQL实现的教务管理系统提供一套完整的毕业设计级项目方案面向计算机、软件工程、电子信息、自动化等专业学生可用于毕业设计、课程设计、项目初期演示或Flask与MySQL开发学习。资源包共66个文件核心包含Python后端逻辑、SQL数据库脚本、HTML/CSS/JS前端页面、项目说明文档以及34张功能运行截图压缩包整体仅3.16MB目录层级简洁便于按代码、文档、资源快速检索。已有195人学习下载参考价值得到初步验证。项目代码经过测试运行成功能够直接部署使用附带的详细文档与SQL脚本有助于理解教务管理的核心业务表结构、路由与前后端交互流程适合在原有基础上扩展选课管理、成绩录入等功能亦可作为毕业设计与课程设计的高分参考模板。1. 为什么我劝你毕设别从零手写教务系统每年到这个季节后台都会收到大量“求一个能跑的教务系统”的消息。大部分人的真实处境是数据库课设要求在两周内交出可演示的系统毕业设计中期检查要看到原型而手写用户登录、权限判断、选课事务、成绩录入这些模块光是联调就能耗掉一个月的周末。这套基于 Python Flask MySQL 的教务管理系统恰恰是那种“目录结构一眼能看懂、跑起来就能演示、改起来有迹可循”的完整工程不是教学 Demo 级别的空壳而是把管理员、教师、学生三类角色的典型业务都落到了代码里配合详细文档很适合拿来当毕设主框架或课设蓝本。需要先说清楚的是它的技术取向后端采用 Flask 作为 Web 框架数据层使用 MySQL整个系统没有引入重型微服务或复杂的前后端分离架构。对多数本科毕设而言这种单体分层结构反而更安全——评审老师关心的是你的业务逻辑是否完整、数据模型是否合理、是否有基本的安全意识而不是你是否会用 Kubernetes。下面我会从表结构设计讲到具体视图函数的写法再到部署时最容易翻车的 MySQL 编码和时区问题争取让你拿到源码后能在两天内跑通并开始改造成自己的东西。2. Flask 教务系统的工程骨架与数据库建模先别急着运行python app.py把工程结构理清楚比跑通更重要。这套项目里的management_system-master目录沿用了 Flask 开发中比较经典的单应用结构app.py或run.py作为入口文件models模块放 ORM 模型views或routes模块放路由templates放 Jinja2 模板static放 CSS/JS。如果你打开压缩包后发现入口文件名有差异比如manage.py也不要慌本质都是创建 Flask 实例、注册蓝图、初始化数据库扩展这三件事。2.1 为什么是这个目录结构Flask 不像 Django 那样通过startproject强制生成固定骨架因此网上能找到的 Flask 项目结构五花八门。但毕设场景下我不推荐把所有路由写在一个文件里哪怕你的系统只有十几个页面。因为教务系统天然带有角色区分把与学生、教师、课程、成绩、用户认证相关的路由全部塞进一个文件到了写论文画架构图的时候你会发现自己根本说不清模块边界。常见的做法是采用蓝图Blueprint做模块切分。以我改过的一个类似项目为例目录可以组织成management_system-master/ ├── app.py # 应用入口创建 Flask 实例 ├── config.py # 配置类存放数据库连接、密钥等 ├── models/ │ ├── __init__.py │ ├── user.py # 用户模型学生/教师/管理员共用或分表 │ ├── course.py # 课程模型 │ └── elective.py # 选课记录模型 ├── views/ │ ├── __init__.py │ ├── auth.py # 登录、注册、退出 │ ├── student.py # 学生端路由 │ ├── teacher.py # 教师端路由 │ └── admin.py # 管理端路由 ├── templates/ # Jinja2 模板 ├── static/ # CSS、JS、图片 ├── requirements.txt └── README.mdapp.py的核心逻辑通常是这样的from flask import Flask from models import db from views.auth import auth_bp from views.student import student_bp from views.teacher import teacher_bp from views.admin import admin_bp app Flask(__name__) app.config.from_object(config.Config) db.init_app(app) app.register_blueprint(auth_bp, url_prefix/auth) app.register_blueprint(student_bp, url_prefix/student) app.register_blueprint(teacher_bp, url_prefix/teacher) app.register_blueprint(admin_bp, url_prefix/admin)db.init_app(app)是 Flask-SQLAlchemy 3.x 时期比较推荐的初始化方式它把 db 对象的创建和 app 的绑定解耦方便在测试中为不同配置创建多个 app 实例。注册蓝图时指定的url_prefix决定了该模块下所有路由的前缀比如学生端/student/course_list管理端/admin/user_manage这种 URL 设计在写论文接口清单时可以少编很多话。2.2 用户表设计三类角色怎么存教务系统最核心的实体不是课程而是用户。学生、教师、管理员三类角色的属性差异很大但毕设阶段不建议用三张表分开存否则登录时你得先判断账号类型再去查对应表平添复杂度。我更倾向于一张user表加role字段区分再根据角色冗余必要信息这种简洁的模型在数据量不大的系统里完全够用。参考项目里的 user 模型大致会包含这些字段字段类型说明idINT 自增主键用户唯一标识usernameVARCHAR(50) 唯一登录账号如学号或工号password_hashVARCHAR(255)密码哈希值禁止存明文roleENUM(admin,teacher,student)角色枚举nameVARCHAR(50)姓名emailVARCHAR(100)邮箱可空create_timeDATETIME注册时间用 SQLAlchemy 写出来就是from datetime import datetime from . import db class User(db.Model): __tablename__ user id db.Column(db.Integer, primary_keyTrue, autoincrementTrue) username db.Column(db.String(50), uniqueTrue, nullableFalse) password_hash db.Column(db.String(255), nullableFalse) role db.Column(db.Enum(admin, teacher, student), nullableFalse) name db.Column(db.String(50), nullableFalse) email db.Column(db.String(100)) create_time db.Column(db.DateTime, defaultdatetime.now) def __repr__(self): return fUser {self.username}password_hash字段长度设置为 255 而不是 64是因为 Flask-Bcrypt 或 Werkzeug 的generate_password_hash输出包含盐值信息长度会超过固定 64 位哈希。看到字段定长不够导致存不进去是初学阶段最常见的低级错误。角色字段用Enum比用字符串的好处在于数据库层面能限制非法值你可以在 MySQL 8.0 以上的客户端里直接验证SHOW COLUMNS FROM user LIKE role看到枚举定义。2.3 课程与选课表多对多关系怎么落库课程和用户之间是典型的多对多关系一个学生选多门课一门课被多个学生选。关系型数据库处理多对多的常规做法是拆出中间表也就是选课记录表。课程表本身相对独立存放课程编号、名称、学分、授课教师 ID、上课时间、容量等基础信息。选课表是这个系统里业务最重的表它同时关联 user学生和 course还承载着成绩字段class Elective(db.Model): __tablename__ elective id db.Column(db.Integer, primary_keyTrue, autoincrementTrue) student_id db.Column(db.Integer, db.ForeignKey(user.id), nullableFalse) course_id db.Column(db.Integer, db.ForeignKey(course.id), nullableFalse) score db.Column(db.Float) # 成绩未录入时为 NULL select_time db.Column(db.DateTime, defaultdatetime.now) __table_args__ ( db.UniqueConstraint(student_id, course_id, nameuk_student_course), )UniqueConstraint在这里不是可有可无的装饰它从数据库层面保证了同一个学生不能重复选同一门课。很多项目只在视图层写了判断if student.has_selected(course)但高并发请求下两个线程同时通过判断就会插入两条重复记录。给中间表加联合唯一索引是成本最低的兜底方案。这也是我在代码评审时最容易给出加分项的地方你不妨拿这个小点去写论文里的“系统健壮性设计”。3. 认证授权与会话管理的实现细节教务系统必须区分登录用户的角色不能让普通学生请求/admin/user_manage就把所有用户信息拉走。这块做不好轻则答辩被老师问住重则系统直接暴露敏感数据。Flask 生态里可以用 Flask-Login 做会话管理也可以纯粹用 Flask 的session对象配合装饰器实现考虑到毕设项目不宜引入太多依赖我这里按纯session方案拆解。3.1 密码加密与登录校验登录流程的底线是不能明文比较密码。Werkzeug 是 Flask 的依赖库本身就提供了generate_password_hash和check_password_hash两个函数不需要额外安装 bcrypt 包。注册用户时生成哈希登录时校验哈希from werkzeug.security import generate_password_hash, check_password_hash from flask import session, flash, redirect, url_for app.route(/auth/login, methods[POST]) def login(): username request.form.get(username) password request.form.get(password) user User.query.filter_by(usernameusername).first() if user and check_password_hash(user.password_hash, password): session.clear() session[user_id] user.id session[role] user.role # 根据角色跳转到不同首页 if user.role admin: return redirect(url_for(admin.dashboard)) elif user.role teacher: return redirect(url_for(teacher.dashboard)) else: return redirect(url_for(student.dashboard)) else: flash(用户名或密码错误) return redirect(url_for(auth.login_page))session.clear()在登录成功时先清空再写入是为了防止会话固定攻击这是一个大多数入门教程不会提到的安全细节。session[role]直接存放在客户端 Cookie 中Flask 默认使用签名 Cookie也就是内容可被解码但无法篡改所以不要在里面存密码之类的敏感信息角色和用户 ID 是允许的。每次请求都从session[user_id]查出当前用户对象比在每个路由里手动判断request.args传参要安全得多。3.2 基于装饰器的角色权限控制写一个login_required装饰器只解决“是否登录”的问题教务系统还需要“角色是否匹配”的校验。我推荐写一个带参数的角色装饰器以下代码是这类项目里的常见模板from functools import wraps from flask import session, abort, redirect, url_for def role_required(*roles): def decorator(func): wraps(func) def wrapper(*args, **kwargs): if user_id not in session: return redirect(url_for(auth.login_page)) if session.get(role) not in roles: abort(403) # 无权限返回 403 return func(*args, **kwargs) return wrapper return decorator应用这个装饰器很容易看出角色隔离的效果app.route(/student/course_list) role_required(student) # 仅学生可访问 def course_list(): # 当前登录学生的可选课程列表 pass app.route(/admin/user_manage) role_required(admin) # 仅管理员可访问 def user_manage(): # 用户管理页面 pass参数说明*roles接收多个字符串参数如果后续某个接口允许教师和学生同时访问直接写role_required(teacher, student)即可。abort(403)会返回一个错误页面你也可以在模板目录下放置自定义的403.html来美化这个响应。使用functools.wraps保留原函数的元信息蝶变后在url_for反向解析路由时不受影响这个细节踩过坑的人都懂——不加wrapsFlask 会报View function is not named correctly之类的诡异错误。3.3 登录态与页面跳转的联动很多初学者会把跳转逻辑写死在模板的a标签里但更稳的做法是让每个角色拥有独立的 dashboard 路由。登录成功后按照角色分别重定向同时在各角色首页中根据当前会话渲染不同的导航菜单。nav {% if session.get(role) admin %} a href/admin/user_manage用户管理/a a href/admin/course_manage课程管理/a {% elif session.get(role) teacher %} a href/teacher/course_list我的课程/a a href/teacher/grade_input成绩录入/a {% else %} a href/student/course_select选课/a a href/student/grade_query成绩查询/a {% endif %} /navJinja2 引擎在模板中可以直接访问 Flask 的session对象不需要通过视图函数额外传参。把导航渲染逻辑放在模板里配合模板继承机制可以在base.html中定义一次所有子页面自动生效。注意session.get(role)在用户未登录时返回 None直接比较不会报错这是比session[role]更安全的一种写法。4. 核心业务逻辑选课事务与成绩录入教务系统的业务痛点集中在选课和成绩录入两个场景。选课要应对并发重复提交成绩录入要处理分数校验和权限边界。这两个功能写好了系统演示效果会远超平均水平。4.1 带容量检查的选课接口选课时必须确认课程尚未满员同时防止同一学生重复选课。前面已经在数据库层面加了联合唯一索引这里再从业务层面做容量校验。为了保证操作的原子性需要在一个事务里完成“查容量-插入选课记录-更新已选数量”三步from sqlalchemy import func from . import db app.route(/student/select_course, methods[POST]) role_required(student) def select_course(): course_id request.form.get(course_id) student_id session[user_id] course Course.query.get(course_id) if not course: flash(课程不存在) return redirect(url_for(student.course_list)) # 统计当前已选人数 selected_count db.session.query( func.count(Elective.id) ).filter(Elective.course_id course_id).scalar() if selected_count course.capacity: flash(该课程已满员) return redirect(url_for(student.course_list)) # 再次检查是否已选过 existed Elective.query.filter_by( student_idstudent_id, course_idcourse_id ).first() if existed: flash(你已经选过这门课程) return redirect(url_for(student.course_list)) elective Elective(student_idstudent_id, course_idcourse_id) db.session.add(elective) try: db.session.commit() flash(选课成功) except Exception: db.session.rollback() flash(选课失败请重试) return redirect(url_for(student.course_list))func.count是 SQLAlchemy 的聚合函数对应 MySQL 的COUNT(*)用scalar()取单值比first()[0]更简洁。这里的并发问题在于“查容量”和“插入”之间可能会有其他请求捷足先登解决的办法要么是给课程表加selected_count字段并通过UPDATE ... WHERE selected_count capacity原子更新要么直接用事务隔离级别为SERIALIZABLE。毕设场景下联合唯一索引已经挡住了大部分重复代码里再加一层业务判断就足够向评审解释清楚了。4.2 成绩录入的逻辑约束成绩录入是教师角色的核心操作需要限定教师只能录自己授课课程的成绩。实现方式是先查出教师 ID 关联的课程列表再校验提交的课程是否在该列表中。成绩字段必须是数字且处于 0 到 100 之间这个校验不能只依赖前端因为 HTTP 请求可以被直接构造。专业一点的写法会把成绩提交封装成一个表单类但 Flask-WTF 在轻量项目里可选可不选。直接手动校验的写法更直观app.route(/teacher/grade_input, methods[POST]) role_required(teacher) def grade_input(): if request.method POST: course_id request.form.get(course_id) student_id request.form.get(student_id) score request.form.get(score) # 校验课程是否属于当前教师 course Course.query.filter_by( idcourse_id, teacher_idsession[user_id] ).first() if not course: abort(403) try: score_val float(score) except (TypeError, ValueError): flash(成绩格式不正确) return redirect(url_for(teacher.course_list)) if score_val 0 or score_val 100: flash(成绩必须在 0 到 100 之间) return redirect(url_for(teacher.course_list)) elective Elective.query.filter_by( student_idstudent_id, course_idcourse_id ).first() if not elective: flash(该学生未选修此课程) return redirect(url_for(teacher.course_list)) elective.score score_val db.session.commit() flash(成绩录入成功) return redirect(url_for(teacher.course_list)) return render_template(grade_input.html)把course_id和teacher_id放在同一个filter_by中查询是权限校验最直接的写法——查询结果为空说明当前登录的老师压根不教这门课这时候直接返回 403不要给任何业务提示避免泄露课程归属关系。浮点分数用Float类型存储如果你需要保留一位小数可以在字段上指定db.Numeric(5, 1)更精确。4.3 学生成绩查询的视图拼装成绩查询页面通常会显示课程名、学分、成绩、是否及格等信息这些数据分散在 course 和 elective 两张表。SQLAlchemy 的join在此时派上用场app.route(/student/grade_query) role_required(student) def grade_query(): student_id session[user_id] results db.session.query( Course.name, Course.credit, Course.teacher_id, Elective.score ).join(Elective, Course.id Elective.course_id) \ .filter(Elective.student_id student_id) \ .all() grade_list [ { course_name: r[0], credit: r[1], score: r[2] if r[2] is not None else 未录入, passed: r[2] is not None and r[2] 60 } for r in results ] return render_template(grade_query.html, grade_listgrade_list)join的写法确实是 SQLAlchemy 里最容易出错的地方注意.join(Elective, Course.id Elective.course_id)中间传入的是两个参数前一个是目标表后一个是连接条件。结果集results是一个元组列表通过下标取字段稍显晦涩用r[0]、r[1]这种方式拿值在模板里不容易读所以我在视图层先做了一次字典转换这个方法在写模板时明显好受很多。5. MySQL 部署配置与常见排错跑通源码只是第一步把系统连上自己的 MySQL 实例才是毕设交付的常规动作。新手在配置数据库连接时遇到的大多数问题都可以归结为编码方式、时区、密码策略和客户端连接方式四类。5.1 与数据库建立连接的配置写法参考项目的config.py会定义一个数据库连接字符串格式是mysqlpymysql://用户名:密码主机:端口/数据库名?charsetutf8mb4。在开启密码较复杂的 MySQL 8.0 时密码中的、/、:必须做 URL 编码否则 Python 会把字符串截断。例如密码是Pssw0rd应该写成P%40ssw0rd。# config.py import os class Config: SECRET_KEY os.environ.get(SECRET_KEY) or dev-key-please-change SQLALCHEMY_DATABASE_URI ( mysqlpymysql://root:your_passwordlocalhost:3306/ education?charsetutf8mb4 ) SQLALCHEMY_TRACK_MODIFICATIONS FalseSQLALCHEMY_TRACK_MODIFICATIONS False是 Flask-SQLAlchemy 2.x 之后的标配关闭对象修改追踪可以节省大量内存。charsetutf8mb4必须显式指定否则中文数据在高版本 MySQL 下可能因默认字符集配置不同而出现乱码或者Incorrect string value错误。另外在 Flask 2.3 及以上版本FLASK 系列配置建议显式使用下划线形式避免命令行下传入小写变量产生静默失效。5.2 MySQL 8.0 认证插件兼容问题如果你连接数据库时遇到Authentication plugin caching_sha2_password cannot be loaded一类报错这不是写在 Python 里的问题而是 MySQL 8.0 默认认证插件与较老版本 PyMySQL 之间的兼容冲突。处理方法有两条路一是升级 PyMySQL 到 1.0 以上版本建议采用二是在 MySQL 中把账户的认证插件改回 mysql_native_password不推荐但能应急ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY your_password; FLUSH PRIVILEGES;实战中我更推荐升级 PyMySQL 而不是修改 MySQL 认证策略原因很简单caching_sha2_password是 MySQL 8.0 的默认行为你为一个毕设项目去改数据库全局安全策略等答辩时老师随口问一句“你的数据库账户认证方式是什么”会比较尴尬。升级依赖只需要在虚拟环境里执行pip install --upgrade pymysql5.3 初始化数据库的正确姿势假设项目里用的是db.create_all()建表。在app.py中追加初始化逻辑with app.app_context(): db.create_all()使用 Flask-SQLAlchemy 时必须在应用上下文中执行建表操作with app.app_context()会把当前 app 推入上下文栈db.create_all()才能找到数据库连接配置。直接在app.py顶层调用db.create_all()而没导入模型的坑是很多项目运行后提示数据表不存在的隐形原因。为了确保模型类被注册到 SQLAlchemy 的 metadata 中你需要保证models/user.py、models/course.py这些模块在create_all()前被 import方法之一是在models/__init__.py里统一导入子模块。建表完成后建议查看一下生成结果mysql -u root -p -e USE education; SHOW TABLES;看到的表名取决于你__tablename__的定义如果继续使用原工程默认名称改动时要留意之后的 SQL 脚本中引用了哪些名字。如果原项目中已经包含sql文件那就优先使用 SQL 文件导入避免因模型与初始数据不一致导致页面缺数据。5.4 连接超时与字符集排错清单把常遇到的错误与排查点整理成快速比对的表现象可能原因排查命令/方法Cant connect to MySQL serverMySQL 服务未启动或端口错误netstat -anp | grep 3306mysql -u root -p手动登录验证Unknown database education数据库未创建CREATE DATABASE education CHARACTER SET utf8mb4;Incorrect string value连接串未指定 utf8mb4检查charsetutf8mb4参数Table user already exists重复执行 create_all改用db.drop_all()或手动处理旧表中文显示为?数据库/表/字段字符集不一致检查SHOW CREATE TABLE user;中 DEFAULT CHARSETBroken pipe/MySQL server has gone awaywait_timeout 过短或连接池回收不及时可在连接串中加入pool_recycle280保持小于 MySQL 的超时时间pool_recycle参数经常被忽略MySQL 默认空闲超时时间是 8 小时但一些云数据库厂商会把它调低到几分钟。当你的 Flask 应用在长时间闲置后首次访问报MySQL server has gone away在连接串里加上pool_recycle280就可以解决这是典型的 PostgreSQL 或 MySQL 连接池回收问题。6. 用管理员账户做一次完整的环境复现最后一个技巧是完整地走一遍从零启动到出数据的流程不跳过任何步骤。这也是我在拿到任何 Flask MySQL 毕业设计源码之后的固定动作能筛掉八成隐藏问题。先在项目根目录创建并激活虚拟环境这个操作在不同操作系统上有语义差异但目的相同python -m venv venv source venv/bin/activate # macOS / Linux venv\Scripts\activate # Windows接着安装依赖。如果压缩包里有requirements.txt直接执行pip install -r requirements.txt如果没有就按最小依赖集合安装pip install flask flask-sqlalchemy pymysql注意Flask 2.3 版本之后flask-sqlalchemy不建议继续安装 2.x直接默认安装 3.x 即可。如果后续运行出现ModuleNotFoundError: No module named MySQLdb那是因为某些教程用mysqlclient做驱动当前系统没有编译环境换成 PyMySQL 并在app.py中加入__init__.py的兼容写法通常会更快。然后手工创建数据库mysql -u root -p输入密码后执行CREATE DATABASE IF NOT EXISTS education DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE education;这里强调utf8mb4_unicode_ci是因为 Python 端按utf8mb4写入如果数据库端是utf8mb4_general_ci也能跑但排序规则的不一致在模糊查询中文时可能产生意外的排序行为。统一这一个排序规则能让后面省心很多。最后启动应用python app.py启动成功后终端会显示Running on http://127.0.0.1:5000用管理员账号登录后逐项检查能不能新增学生账号、能不能创建课程、学生登录后能不能选课、教师登录后能不能录入成绩。这四步串起来就是一个能写进论文里流程图的“系统测试用例”的雏形。有一个更高阶的用法想提一下如果你要把这份代码作为自己的毕设不要停留在改个标题和 Logo 的程度。我建议你找到requirements.txt把每个依赖的主版本号固定下来然后在README.md中记录你实际操作时的 Python 版本和 MySQL 版本。答辩演示时老师经常盯着终端问你“为什么你的环境能跑而我的跑不起来”届时你给出这样的记录陈述自己的工程严谨性往往比功能演示本身更值钱。本文还有配套的精品资源点击获取