尧图网站建设 
简介基于Python与MySQL实现的校园学习助手网站采用B/S结构面向Web开发课程设计场景适合正在学习Django框架的学生或开发者参考。前端使用Bootstrap搭建响应式页面并配合JavaScript与jQuery实现动态交互后端基于Django 2.0完成业务逻辑整体分为基本、博客、日程、小组四个模块覆盖用户注册登录、好友添加与删除、博客发布与删除、评论、收藏、日程添加与完成确认以及小组任务创建和分配等完整闭环。压缩包内共有1840个文件类型以SVG图标为主另有CSS、JavaScript、HTML静态页、Python源码、字体、地图文件等包体总大小约38.37MB目录结构按照模块与静态资源分区存放便于直接查阅、运行和二次开发。目前已有133人学习该资源对需要课程设计完整方案或希望从实际代码中理解Django与MySQL联动开发的人而言具有切实的参考价值。1. 基于 PythonMySql 的校园学习助手网站这份课程设计资源到底能落地多少很多同学拿到“基于 PythonMySql 实现Web校园学习助手网站”这类课程设计资源后第一反应是赶紧双击运行结果立刻被 MySQL 版本、编码、端口占满三座大山拦住。这份编号 100010105 的资源代码完整度比一般网盘资源靠谱核心是 B/S 结构Python 负责业务逻辑MySQL 存数据Web 端做交互正好覆盖课程设计最看重的三层架构。它能帮你省掉从零搭项目的时间但下载不是终点跑通之前需要把环境、建库、配置三件事按顺序走完。适合正在做课设的学生、需要复现项目的老师以及想快速借用模板的开发者。只要你愿意按本文的顺序执行大概率能在半个小时内看到登录页。2. 技术选型与目录重建为什么 B/S 结构选 Flask 而不是裸脚本2.1 课程设计场景下Flask 为什么比直接用 Django 更合适校园学习助手这种项目本质是“用户管理 课程管理 任务管理 学习笔记”的 CRUD 系统。网络上同类资源有的用 Flask有的用 Django有的甚至直接写 CGI。但从答辩和复现角度我更推荐先按 Flask 来理解因为它的核心逻辑足够少路由、模板、请求处理都能在几个文件里讲清楚老引导老师问“你这里怎么做到的”时能一条线把代码讲完。Flask 属于轻量级 Web 框架默认自带开发服务器和 Jinja2 模板引擎配合 PyMySQL 连接 MySQL就构成了完整的 B/S 架构浏览器端发 HTTP 请求Flask 端路由到业务函数数据从 MySQL 读出后渲染成页面返回。对课程设计来说这种结构比 Django 更容易展示分层思想模板层放 HTML视图层放 Python 函数数据层放 SQL 查询。Django 虽然自带 ORM 和 Admin但封装太多很多代码到了答辩现场反而讲不透。从运行成本看Flask 项目只需要安装几个 Python 包不需要额外进程也不用配 Django 的 settings 那么多参数。校园学习助手的数据量很小最多几百条任务记录MySQL 的性能完全够用。真正的坑往往不在框架而在“代码依赖”和“数据库状态”不一致比如本地跑通到教室演示时因为少了某个包直接崩掉这类问题后面会专门展开。2.2 从下载包到可运行目录、虚拟环境、依赖文件落一遍拿到资源包后不要急着双击 app.py先把目录整理成统一结构。校内课程设计常用的目录一般长这样campus-assistant/ ├── app.py # Flask 主入口包含路由 ├── db.py # MySQL 连接与查询封装 ├── init_db.sql # 建库建表脚本 ├── templates/ # Jinja2 页面模板 │ ├── login.html │ ├── dashboard.html │ └── task_form.html ├── static/ # CSS/JS/图片 │ ├── style.css │ └── main.js ├── requirements.txt # 第三方依赖清单 └── README.md如果你的下载包里有 app.py、db.py、init_db.sql直接按这个结构对齐如果没有后续章节会给一份能用的最小代码你照着建文件就行。第一步先用命令行创建虚拟环境并安装依赖这一步最大的作用是避免把 Python 全局环境搞乱不同课程设计之间包版本打架太常见了。cd campus-assistant python -m venv venv # Windows 用下面这行激活 venv\Scripts\activate # macOS/Linux 用 source venv/bin/activate pip install flask pymysql这里 Flask 和 PyMySQL 是两个最核心的依赖。Flask 提供render_template、request、session这类 Web 能力PyMySQL 是纯 Python 实现的 MySQL 客户端比 MySQLdb 在 Windows 上省去编译步骤课程设计场景用起来最稳。requirements.txt 如果下载包里没有就手动创建并把版本写进去flask3.0.0 pymysql1.1.0 cryptography42.0.5cryptography 不是给业务用的而是 MySQL 8 默认启用caching_sha2_password认证旧版 PyMySQL 连接时可能报sha256_password相关错误装上 cryptography 就能绕过这个坑。实际安装时如果网络环境很慢可以用国内镜像源加速但我不建议在答辩时换第三方镜像直接默认官方源安装最省事。装完依赖后跑一句python app.py如果提示ModuleNotFoundError说明某个包没装上回到虚拟环境重新 install 即可。3. 数据库设计到 Python 接口先把 MySQL 的表立住再写路由3.1 四张核心表用户、课程、任务、学习笔记B/S 结构的课程设计里数据库设计是答辩老师必问的点。如果只建一张大表存所有字段虽然功能能跑但表关系完全说不出口。我这里按最简单但完整的四表方案展开users用户表、courses课程表、tasks学习任务表、notes学习笔记表。用户和课程之间是选课关系这里简化成用户直接引用课程 ID任务属于某个用户的某门课程笔记也挂在用户和课程下。先看建库建表脚本我建议你直接复制到 MySQL 里执行使用 Navicat 或命令行都行。CREATE DATABASE IF NOT EXISTS campus_assistant DEFAULT CHARSET utf8mb4; USE campus_assistant; CREATE TABLE users ( id INT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL UNIQUE, password_hash VARCHAR(200) NOT NULL, role ENUM(student, teacher) DEFAULT student, created_at DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE courses ( id INT AUTO_INCREMENT PRIMARY KEY, course_name VARCHAR(100) NOT NULL, teacher_name VARCHAR(50), credit DECIMAL(3,1) DEFAULT 2.0 ); CREATE TABLE tasks ( id INT AUTO_INCREMENT PRIMARY KEY, user_id INT NOT NULL, course_id INT NOT NULL, title VARCHAR(100) NOT NULL, due_date DATE, status TINYINT DEFAULT 0, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, CONSTRAINT fk_task_user FOREIGN KEY (user_id) REFERENCES users(id), CONSTRAINT fk_task_course FOREIGN KEY (course_id) REFERENCES courses(id) ); CREATE TABLE notes ( id INT AUTO_INCREMENT PRIMARY KEY, user_id INT NOT NULL, course_id INT NOT NULL, content TEXT, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, CONSTRAINT fk_note_user FOREIGN KEY (user_id) REFERENCES users(id), CONSTRAINT fk_note_course FOREIGN KEY (course_id) REFERENCES courses(id) );这里有几个参数值得解释。utf8mb4是必须的因为 MySQL 的utf8只占 3 字节存不了完整的中文表情和特殊符号课程设计里如果学生把微信表情复制进笔记页面很可能出现问号。created_at用DEFAULT CURRENT_TIMESTAMP可以在插入数据时自动生成时间不用业务代码里手动datetime.now()。status TINYINT用来表示任务完成状态0 代表未完成1 代表已完成比BOOL更省空间。外键约束FOREIGN KEY能保证任务表里的course_id一定存在于课程表答辩时老师问数据一致性这组外键就是最好的答案。建完表后顺手插入两条测试数据方便后面登录和列表调试。常见做法是直接在init_db.sql末尾追加INSERT INTO users (username, password_hash) VALUES (admin, pbkdf2:sha256:...自己的hash...); INSERT INTO courses (course_name, teacher_name, credit) VALUES (Python程序设计, 张老师, 3.0);密码哈希不要手写后面会给出 Python 生成方式。这里先留空等应用跑起来后注册一个用户就行。3.2 用 PyMySQL 做连接与参数化查询封装一个不被 SQL 注入的 db.py很多课程设计源码喜欢在路由里直接写pymysql.connect每个视图函数都重复一遍。刚开始写很爽后面改密码或数据库名时要改十几个文件非常容易漏。我一般会单独写一个db.py把连接和查询统一封装成两个函数。# db.py import pymysql DB_CONFIG { host: 127.0.0.1, port: 3306, user: root, password: 你的数据库密码, database: campus_assistant, charset: utf8mb4, cursorclass: pymysql.cursors.DictCursor, } def get_connection(): return pymysql.connect(**DB_CONFIG) def query(sql, paramsNone): conn get_connection() try: with conn.cursor() as cursor: cursor.execute(sql, params) return cursor.fetchall() finally: conn.close() def execute(sql, paramsNone): conn get_connection() try: with conn.cursor() as cursor: cursor.execute(sql, params) conn.commit() return cursor.rowcount finally: conn.close()这段代码有三个关键点。第一cursorclass设为DictCursor查询结果就是字典列表访问row[username]比row[0]可读性好得多。第二所有 SQL 都走cursor.execute(sql, params)参数用%s占位而不是字符串拼接这是防止 SQL 注入最有效的办法答辩时你说用了参数化查询老师不会在这个点上纠缠。第三finally后面一定要conn.close()否则课程设计演示时反复刷新页面会把 MySQL 连接数耗尽出现Too many connections。如果你下载的源码里没有db.py或者原本叫mysql_conn.py建议直接改成这个接口。后续所有路由代码都只调用query和execute不需要关心连接细节。DB_CONFIG里的password字段在实际环境中建议从环境变量读取但课程设计通常没必要只要代码交出去时把密码改成自己的即可。4. 前端页面与后端路由登录态、任务列表、作业提交请求4.1 登录与 session用 Flask 的 session 把登录态保持住校园学习助手必须区分用户所以登录页是第一个落地功能。这里不推荐用明文密码存 MySQL至少要过一遍哈希。Flask 自带的werkzeug.security已经提供了密码散列方案不需要额外安装包。# app.py from flask import Flask, render_template, request, session, redirect, url_for from werkzeug.security import check_password_hash, generate_password_hash from db import query, execute app Flask(__name__) # 课程设计项目里固定 secret_key重启后 session 不会失效 app.secret_key campus-assistant-course-design-key app.route(/regist, methods[GET, POST]) def regist(): if request.method POST: username request.form.get(username) password request.form.get(password) password_hash generate_password_hash(password) try: execute(INSERT INTO users(username, password_hash) VALUES(%s, %s), (username, password_hash)) return redirect(url_for(login)) except Exception as e: return f注册失败{e} return render_template(regist.html) app.route(/login, methods[GET, POST]) def login(): if request.method POST: username request.form.get(username) password request.form.get(password) user_rows query(SELECT * FROM users WHERE username%s, (username,)) if user_rows and check_password_hash(user_rows[0][password_hash], password): session[user_id] user_rows[0][id] session[username] user_rows[0][username] return redirect(url_for(dashboard)) return render_template(login.html, error用户名或密码错误) return render_template(login.html)generate_password_hash会生成一个随机盐加哈希的字符串每次注册时哈希值不同但校验过程是一致的。check_password_hash用于登录时比对它内部处理盐值你不需要关心具体算法只要记住永不用明文密码即可。session是 Flask 的客户端会话本质是加密 Cookie但secret_key必须在程序里固定住。我见过很多项目把secret_key留空或写成随机生成结果应用一重启之前登录的用户全部退出答辩演示会非常尴尬。数据库里如果已经有明文密码的用户建议先删掉重新走注册流程。execute函数内部做了commit不需要再手动调db.commit()这是封装db.py的好处。4.2 学习任务页面把数据渲染成 Web 列表并处理表单提交登录之后用户应该看到属于自己的学习任务列表。这里用一条 JOIN 查询把任务表和课程表关联起来显示课程名称而不仅仅是课程 ID。路由函数先检查 session再查数据最后渲染模板。app.route(/dashboard) def dashboard(): if user_id not in session: return redirect(url_for(login)) tasks query( SELECT t.id, t.title, t.due_date, t.status, c.course_name FROM tasks t JOIN courses c ON t.course_id c.id WHERE t.user_id %s ORDER BY t.due_date ASC , (session[user_id],)) return render_template(dashboard.html, taskstasks)模板侧用 Jinja2 的for循环渲染表格!-- templates/dashboard.html -- table thead tr th任务标题/th th课程/th th截止日期/th th状态/th /tr /thead tbody {% for t in tasks %} tr td{{ t[title] }}/td td{{ t[course_name] }}/td td{{ t[due_date] }}/td td{{ 已完成 if t[status] 1 else 未完成 }}/td /tr {% endfor %} /tbody /table这里需要注意的是tasks是query返回的字典列表在 Jinja2 中可以按字典键取值。如果下载资源用的是列表索引模板就要写成t[0]、t[1]那种代码很不直观建议统一用DictCursor。新增任务功能也要保持 POST 语义。初学课程设计最常见的翻车点是所有操作都用 GET导致浏览器刷新页面时重复提交日志里全是重复记录。正确做法是表单提交到 POST 路由处理完后再重定向回列表页。app.route(/task/add, methods[POST]) def task_add(): if user_id not in session: return redirect(url_for(login)) title request.form.get(title) course_id request.form.get(course_id) due_date request.form.get(due_date) if not title or not course_id: return 标题和课程不能为空 execute( INSERT INTO tasks(user_id, course_id, title, due_date) VALUES(%s, %s, %s, %s) , (session[user_id], course_id, title, due_date)) return redirect(url_for(dashboard))由于execute内部完成事务提交这个路由里不需要额外写commit。course_id从下拉框提交前端页面里需要用query(SELECT id, course_name FROM courses)渲染选项列表。这些就是 B/S 结构中“前端表单-后端接收-数据库写入-页面重定向”的最小闭环课程设计的核心交互过程在这个闭环里都能覆盖。5. 校园学习助手项目避坑与常见问题排查五个让人当场卡壳的点5.1 数据库连接与中文编码碰到“拒绝访问”和乱码先从 MySQL 端查坑一PyMySQL 连接 MySQL 8 报Access denied for user rootlocalhost现象明明密码没错但pymysql.connect()就是报 1045 错误有时候还提示Authentication plugin caching_sha2_password cannot be loaded。原因MySQL 8 默认的认证插件是caching_sha2_password而一部分旧版本的 PyMySQL 或 MySQLdb 只支持mysql_native_password。有些课程设计源码是两年前写的用的还是老连接库自然就卡住了。解决先在 MySQL 里执行下面这条 SQL把认证方式改掉然后再运行 Flask 程序。ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码; FLUSH PRIVILEGES;如果你是下载资源里自带的旧版 PyMySQL也可以直接升级pip install -U pymysql cryptography升级后两种认证都支持。我建议两条路都走一遍反正都是免费方案能让你少折腾不少。坑二数据库和页面中文全部变成问号现象页面表格里的“高等数学”显示成“???”MySQL 命令行里查出来也是乱码。原因建表时用了默认字符集或者连接参数里没写charsetutf8mb4而本机 MySQL 默认字符集又不是 utf8mb4。课程设计里最容易出现这种问题因为 Windows 上安装 MySQL 经常会选latin1作为默认编码。解决回到init_db.sql把CREATE DATABASE语句后面的DEFAULT CHARSET utf8mb4好好检查一遍。同时在db.py的DB_CONFIG里必须写charset: utf8mb4。如果库已经建错了用下面的语句改掉ALTER DATABASE campus_assistant CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;改数据库字符集不会自动更新已存在的表所以表也统一改一下把courses、tasks、notes分别执行ALTER TABLE xxx CONVERT TO CHARACTER SET utf8mb4。这步做完删除旧表重新执行init_db.sql是最干净的方案因为课程设计初期没有真实数据重建成本很低。5.2 接口与运行环境外键、session、端口三个高频翻车点坑三Jinja2 页面渲染时突然 500提示TypeError: NoneType object is not subscriptable现象登录后进到 dashboard 页面浏览器报内部服务器错误命令行日志显示TypeError定位到模板里某个字段取不到值。原因很大概率是任务表里有一条数据的course_id指向了不存在的课程或者 JOIN 查出来的结果里course_name是NULL。下载包里如果自带测试数据有些测试数据的user_id是 1但当前登录用户是 2列表虽然查到了空结果模板里却对空列表做了t[0]操作。解决先在 MySQL 里手动执行 JOIN 查询确认返回结果里有没有NULL。然后回到模板把t[title]这种取数方式改成t.get(title, )或者在路由里做一层默认值处理。我的习惯是模板里只用{% for t in tasks %}加{{ t.get(title, ) }}这是 Django 和 Flask 模板引擎都支持的写法能避开一大批空值问题。坑四登录成功后刷新页面又退回登录页session 总是失效现象用户在浏览器里明明点了登录跳转到 dashboard 了但按一下 F5 就回到 login 页或者浏览器开着程序重启后全部需要重新登录。原因主要是app.secret_key的问题。如果代码里写成app.secret_key os.urandom(24)每次 Flask 进程重启都会生成一个新签名密钥旧 session 全部失效。有些源码写app.secret_key Flask 同样无法稳定签名。解决把secret_key写死成一段固定字符串比如campus-assistant-2024。就算代码公开也没关系课程设计项目的安全级别不用太高保持 session 稳定比临时改一个随机密钥更重要。另外开发服务器要开启app.run(debugFalse)有的同学为了看报错把debugTrue一直开着debug 模式下的调试器会干扰 session 的读取这也是一个隐藏因素。坑五Address already in useFlask 5000 端口或 MySQL 3306 端口被占用现象运行python app.py时终端提示端口被占用服务起不来或者 MySQL 命令行能连但 Flask 报名称为本地端口已使用。原因Windows 上可能是之前一次课程设计残留的 Python 进程还占着 5000 端口也可能是 MySQL 装了两份3306 被第一个实例占住。解决先用netstat找到占用端口的 PID然后决定是杀掉进程还是换端口。netstat -ano | findstr :5000 taskkill /PID 这里写PID /F如果不想杀进程就改 Flask 启动端口比如app.run(port5001)。MySQL 端口冲突则需要去my.ini里改port3307同时修改db.py的DB_CONFIG中port。课程设计交付时最好在 README 里写清楚“默认端口是 3306如果冲突请改哪几个文件”这个细节很容易被答辩老师当作加分项。6. 别急着交用自动化冒烟测试和 Waitress 跑一个能演示的稳定版本6.1 冒烟测试脚本不点页面也能验证核心链路演示前最怕的是手忙脚乱点错按钮。我习惯先写一个冒烟脚本把所有核心功能自动跑一遍确认没问题之后再打开浏览器给老师演示。这个脚本基于 Python 的requests库模拟真实 HTTP 请求。# smoke_test.py import requests BASE http://127.0.0.1:5000 s requests.Session() # 1. 登录 login_resp s.post(f{BASE}/login, data{ username: admin, password: 123456 }, allow_redirectsTrue) assert 我的任务 in login_resp.text, 登录后页面没有出现任务关键字 # 2. 查看任务列表 dashboard_resp s.get(f{BASE}/dashboard) assert Python in dashboard_resp.text, 任务列表里没有课程信息 # 3. 新增任务 task_resp s.post(f{BASE}/task/add, data{ title: 冒烟测试任务, course_id: 1, due_date: 2024-12-30 }) assert task_resp.status_code 200 print(冒烟测试通过)脚本里有三个断言覆盖登录、查询、写入三个关键动作。注意course_id要和数据库里的课程 ID 对应如果你在课程表里插的数据 ID 不是 1改成实际值。allow_redirectsTrue是为了让requests跟随 Flask 的redirect到 dashboard。登录后的 session 由requests.Session()自动保持和浏览器行为一致。在命令行跑python smoke_test.py如果输出“冒烟测试通过”基本可以放心演示。如果失败看断言的具体位置是登录失败、列表没有数据还是新增失败然后再回到对应路由排查。6.2 用 Waitress 替代 Flask 开发服务器演示时不卡壳Flask 自带的开发服务器会在控制台打印一堆请求日志而且并发能力很弱演示时一旦有老师打开 F12 连续刷新页面可能卡住。更专业的做法是用 Waitress 做生产级服务器它是纯 Python 实现的 WSGI 服务器Windows 上安装使用都非常稳定。pip install waitress waitress-serve --port8000 app:appapp:app的含义是“从 app.py 中导出名为 app 的 Flask 实例”。如果你把app Flask(__name__)写在一个叫main.py的文件里命令就要改成main:app。启动后访问http://127.0.0.1:8000效果和开发服务器一样但没有那些Debugger: active的提示更适合作为一个正式版本来演示。用 Waitress 时要注意它默认监听127.0.0.1如果需要在机房其他电脑上访问加参数--listen0.0.0.0:8000。课程设计演示通常是自己电脑上连投影屏不需要开外部访问所以默认即可。另外Waitress 不处理静态文件的优化但校园学习助手项目静态文件很少完全不需要折腾 Nginx。我还养成了一个习惯每次演示前先跑一遍smoke_test.py确认核心链路通了之后再用 Waitress 启动服务。以前我拿到课程设计源码总想直接点开就展示结果遇到 session 失效、中文乱码、端口占用各种问题只能在讲台上现场改代码。从那以后我每次交课程设计都会强制走一遍“MySQL 建库 → 初始化数据 → 冒烟测试 → Waitress 启动”的完整流程确认没有玄学问题才截图希望帮到你。本文还有配套的精品资源点击获取 基于Python+MySQL的校园学习助手网站：课程设计资源复现与避坑指南
简介基于Python与MySQL实现的校园学习助手网站采用B/S结构面向Web开发课程设计场景适合正在学习Django框架的学生或开发者参考。前端使用Bootstrap搭建响应式页面并配合JavaScript与jQuery实现动态交互后端基于Django 2.0完成业务逻辑整体分为基本、博客、日程、小组四个模块覆盖用户注册登录、好友添加与删除、博客发布与删除、评论、收藏、日程添加与完成确认以及小组任务创建和分配等完整闭环。压缩包内共有1840个文件类型以SVG图标为主另有CSS、JavaScript、HTML静态页、Python源码、字体、地图文件等包体总大小约38.37MB目录结构按照模块与静态资源分区存放便于直接查阅、运行和二次开发。目前已有133人学习该资源对需要课程设计完整方案或希望从实际代码中理解Django与MySQL联动开发的人而言具有切实的参考价值。1. 基于 PythonMySql 的校园学习助手网站这份课程设计资源到底能落地多少很多同学拿到“基于 PythonMySql 实现Web校园学习助手网站”这类课程设计资源后第一反应是赶紧双击运行结果立刻被 MySQL 版本、编码、端口占满三座大山拦住。这份编号 100010105 的资源代码完整度比一般网盘资源靠谱核心是 B/S 结构Python 负责业务逻辑MySQL 存数据Web 端做交互正好覆盖课程设计最看重的三层架构。它能帮你省掉从零搭项目的时间但下载不是终点跑通之前需要把环境、建库、配置三件事按顺序走完。适合正在做课设的学生、需要复现项目的老师以及想快速借用模板的开发者。只要你愿意按本文的顺序执行大概率能在半个小时内看到登录页。2. 技术选型与目录重建为什么 B/S 结构选 Flask 而不是裸脚本2.1 课程设计场景下Flask 为什么比直接用 Django 更合适校园学习助手这种项目本质是“用户管理 课程管理 任务管理 学习笔记”的 CRUD 系统。网络上同类资源有的用 Flask有的用 Django有的甚至直接写 CGI。但从答辩和复现角度我更推荐先按 Flask 来理解因为它的核心逻辑足够少路由、模板、请求处理都能在几个文件里讲清楚老引导老师问“你这里怎么做到的”时能一条线把代码讲完。Flask 属于轻量级 Web 框架默认自带开发服务器和 Jinja2 模板引擎配合 PyMySQL 连接 MySQL就构成了完整的 B/S 架构浏览器端发 HTTP 请求Flask 端路由到业务函数数据从 MySQL 读出后渲染成页面返回。对课程设计来说这种结构比 Django 更容易展示分层思想模板层放 HTML视图层放 Python 函数数据层放 SQL 查询。Django 虽然自带 ORM 和 Admin但封装太多很多代码到了答辩现场反而讲不透。从运行成本看Flask 项目只需要安装几个 Python 包不需要额外进程也不用配 Django 的 settings 那么多参数。校园学习助手的数据量很小最多几百条任务记录MySQL 的性能完全够用。真正的坑往往不在框架而在“代码依赖”和“数据库状态”不一致比如本地跑通到教室演示时因为少了某个包直接崩掉这类问题后面会专门展开。2.2 从下载包到可运行目录、虚拟环境、依赖文件落一遍拿到资源包后不要急着双击 app.py先把目录整理成统一结构。校内课程设计常用的目录一般长这样campus-assistant/ ├── app.py # Flask 主入口包含路由 ├── db.py # MySQL 连接与查询封装 ├── init_db.sql # 建库建表脚本 ├── templates/ # Jinja2 页面模板 │ ├── login.html │ ├── dashboard.html │ └── task_form.html ├── static/ # CSS/JS/图片 │ ├── style.css │ └── main.js ├── requirements.txt # 第三方依赖清单 └── README.md如果你的下载包里有 app.py、db.py、init_db.sql直接按这个结构对齐如果没有后续章节会给一份能用的最小代码你照着建文件就行。第一步先用命令行创建虚拟环境并安装依赖这一步最大的作用是避免把 Python 全局环境搞乱不同课程设计之间包版本打架太常见了。cd campus-assistant python -m venv venv # Windows 用下面这行激活 venv\Scripts\activate # macOS/Linux 用 source venv/bin/activate pip install flask pymysql这里 Flask 和 PyMySQL 是两个最核心的依赖。Flask 提供render_template、request、session这类 Web 能力PyMySQL 是纯 Python 实现的 MySQL 客户端比 MySQLdb 在 Windows 上省去编译步骤课程设计场景用起来最稳。requirements.txt 如果下载包里没有就手动创建并把版本写进去flask3.0.0 pymysql1.1.0 cryptography42.0.5cryptography 不是给业务用的而是 MySQL 8 默认启用caching_sha2_password认证旧版 PyMySQL 连接时可能报sha256_password相关错误装上 cryptography 就能绕过这个坑。实际安装时如果网络环境很慢可以用国内镜像源加速但我不建议在答辩时换第三方镜像直接默认官方源安装最省事。装完依赖后跑一句python app.py如果提示ModuleNotFoundError说明某个包没装上回到虚拟环境重新 install 即可。3. 数据库设计到 Python 接口先把 MySQL 的表立住再写路由3.1 四张核心表用户、课程、任务、学习笔记B/S 结构的课程设计里数据库设计是答辩老师必问的点。如果只建一张大表存所有字段虽然功能能跑但表关系完全说不出口。我这里按最简单但完整的四表方案展开users用户表、courses课程表、tasks学习任务表、notes学习笔记表。用户和课程之间是选课关系这里简化成用户直接引用课程 ID任务属于某个用户的某门课程笔记也挂在用户和课程下。先看建库建表脚本我建议你直接复制到 MySQL 里执行使用 Navicat 或命令行都行。CREATE DATABASE IF NOT EXISTS campus_assistant DEFAULT CHARSET utf8mb4; USE campus_assistant; CREATE TABLE users ( id INT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL UNIQUE, password_hash VARCHAR(200) NOT NULL, role ENUM(student, teacher) DEFAULT student, created_at DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE courses ( id INT AUTO_INCREMENT PRIMARY KEY, course_name VARCHAR(100) NOT NULL, teacher_name VARCHAR(50), credit DECIMAL(3,1) DEFAULT 2.0 ); CREATE TABLE tasks ( id INT AUTO_INCREMENT PRIMARY KEY, user_id INT NOT NULL, course_id INT NOT NULL, title VARCHAR(100) NOT NULL, due_date DATE, status TINYINT DEFAULT 0, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, CONSTRAINT fk_task_user FOREIGN KEY (user_id) REFERENCES users(id), CONSTRAINT fk_task_course FOREIGN KEY (course_id) REFERENCES courses(id) ); CREATE TABLE notes ( id INT AUTO_INCREMENT PRIMARY KEY, user_id INT NOT NULL, course_id INT NOT NULL, content TEXT, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, CONSTRAINT fk_note_user FOREIGN KEY (user_id) REFERENCES users(id), CONSTRAINT fk_note_course FOREIGN KEY (course_id) REFERENCES courses(id) );这里有几个参数值得解释。utf8mb4是必须的因为 MySQL 的utf8只占 3 字节存不了完整的中文表情和特殊符号课程设计里如果学生把微信表情复制进笔记页面很可能出现问号。created_at用DEFAULT CURRENT_TIMESTAMP可以在插入数据时自动生成时间不用业务代码里手动datetime.now()。status TINYINT用来表示任务完成状态0 代表未完成1 代表已完成比BOOL更省空间。外键约束FOREIGN KEY能保证任务表里的course_id一定存在于课程表答辩时老师问数据一致性这组外键就是最好的答案。建完表后顺手插入两条测试数据方便后面登录和列表调试。常见做法是直接在init_db.sql末尾追加INSERT INTO users (username, password_hash) VALUES (admin, pbkdf2:sha256:...自己的hash...); INSERT INTO courses (course_name, teacher_name, credit) VALUES (Python程序设计, 张老师, 3.0);密码哈希不要手写后面会给出 Python 生成方式。这里先留空等应用跑起来后注册一个用户就行。3.2 用 PyMySQL 做连接与参数化查询封装一个不被 SQL 注入的 db.py很多课程设计源码喜欢在路由里直接写pymysql.connect每个视图函数都重复一遍。刚开始写很爽后面改密码或数据库名时要改十几个文件非常容易漏。我一般会单独写一个db.py把连接和查询统一封装成两个函数。# db.py import pymysql DB_CONFIG { host: 127.0.0.1, port: 3306, user: root, password: 你的数据库密码, database: campus_assistant, charset: utf8mb4, cursorclass: pymysql.cursors.DictCursor, } def get_connection(): return pymysql.connect(**DB_CONFIG) def query(sql, paramsNone): conn get_connection() try: with conn.cursor() as cursor: cursor.execute(sql, params) return cursor.fetchall() finally: conn.close() def execute(sql, paramsNone): conn get_connection() try: with conn.cursor() as cursor: cursor.execute(sql, params) conn.commit() return cursor.rowcount finally: conn.close()这段代码有三个关键点。第一cursorclass设为DictCursor查询结果就是字典列表访问row[username]比row[0]可读性好得多。第二所有 SQL 都走cursor.execute(sql, params)参数用%s占位而不是字符串拼接这是防止 SQL 注入最有效的办法答辩时你说用了参数化查询老师不会在这个点上纠缠。第三finally后面一定要conn.close()否则课程设计演示时反复刷新页面会把 MySQL 连接数耗尽出现Too many connections。如果你下载的源码里没有db.py或者原本叫mysql_conn.py建议直接改成这个接口。后续所有路由代码都只调用query和execute不需要关心连接细节。DB_CONFIG里的password字段在实际环境中建议从环境变量读取但课程设计通常没必要只要代码交出去时把密码改成自己的即可。4. 前端页面与后端路由登录态、任务列表、作业提交请求4.1 登录与 session用 Flask 的 session 把登录态保持住校园学习助手必须区分用户所以登录页是第一个落地功能。这里不推荐用明文密码存 MySQL至少要过一遍哈希。Flask 自带的werkzeug.security已经提供了密码散列方案不需要额外安装包。# app.py from flask import Flask, render_template, request, session, redirect, url_for from werkzeug.security import check_password_hash, generate_password_hash from db import query, execute app Flask(__name__) # 课程设计项目里固定 secret_key重启后 session 不会失效 app.secret_key campus-assistant-course-design-key app.route(/regist, methods[GET, POST]) def regist(): if request.method POST: username request.form.get(username) password request.form.get(password) password_hash generate_password_hash(password) try: execute(INSERT INTO users(username, password_hash) VALUES(%s, %s), (username, password_hash)) return redirect(url_for(login)) except Exception as e: return f注册失败{e} return render_template(regist.html) app.route(/login, methods[GET, POST]) def login(): if request.method POST: username request.form.get(username) password request.form.get(password) user_rows query(SELECT * FROM users WHERE username%s, (username,)) if user_rows and check_password_hash(user_rows[0][password_hash], password): session[user_id] user_rows[0][id] session[username] user_rows[0][username] return redirect(url_for(dashboard)) return render_template(login.html, error用户名或密码错误) return render_template(login.html)generate_password_hash会生成一个随机盐加哈希的字符串每次注册时哈希值不同但校验过程是一致的。check_password_hash用于登录时比对它内部处理盐值你不需要关心具体算法只要记住永不用明文密码即可。session是 Flask 的客户端会话本质是加密 Cookie但secret_key必须在程序里固定住。我见过很多项目把secret_key留空或写成随机生成结果应用一重启之前登录的用户全部退出答辩演示会非常尴尬。数据库里如果已经有明文密码的用户建议先删掉重新走注册流程。execute函数内部做了commit不需要再手动调db.commit()这是封装db.py的好处。4.2 学习任务页面把数据渲染成 Web 列表并处理表单提交登录之后用户应该看到属于自己的学习任务列表。这里用一条 JOIN 查询把任务表和课程表关联起来显示课程名称而不仅仅是课程 ID。路由函数先检查 session再查数据最后渲染模板。app.route(/dashboard) def dashboard(): if user_id not in session: return redirect(url_for(login)) tasks query( SELECT t.id, t.title, t.due_date, t.status, c.course_name FROM tasks t JOIN courses c ON t.course_id c.id WHERE t.user_id %s ORDER BY t.due_date ASC , (session[user_id],)) return render_template(dashboard.html, taskstasks)模板侧用 Jinja2 的for循环渲染表格!-- templates/dashboard.html -- table thead tr th任务标题/th th课程/th th截止日期/th th状态/th /tr /thead tbody {% for t in tasks %} tr td{{ t[title] }}/td td{{ t[course_name] }}/td td{{ t[due_date] }}/td td{{ 已完成 if t[status] 1 else 未完成 }}/td /tr {% endfor %} /tbody /table这里需要注意的是tasks是query返回的字典列表在 Jinja2 中可以按字典键取值。如果下载资源用的是列表索引模板就要写成t[0]、t[1]那种代码很不直观建议统一用DictCursor。新增任务功能也要保持 POST 语义。初学课程设计最常见的翻车点是所有操作都用 GET导致浏览器刷新页面时重复提交日志里全是重复记录。正确做法是表单提交到 POST 路由处理完后再重定向回列表页。app.route(/task/add, methods[POST]) def task_add(): if user_id not in session: return redirect(url_for(login)) title request.form.get(title) course_id request.form.get(course_id) due_date request.form.get(due_date) if not title or not course_id: return 标题和课程不能为空 execute( INSERT INTO tasks(user_id, course_id, title, due_date) VALUES(%s, %s, %s, %s) , (session[user_id], course_id, title, due_date)) return redirect(url_for(dashboard))由于execute内部完成事务提交这个路由里不需要额外写commit。course_id从下拉框提交前端页面里需要用query(SELECT id, course_name FROM courses)渲染选项列表。这些就是 B/S 结构中“前端表单-后端接收-数据库写入-页面重定向”的最小闭环课程设计的核心交互过程在这个闭环里都能覆盖。5. 校园学习助手项目避坑与常见问题排查五个让人当场卡壳的点5.1 数据库连接与中文编码碰到“拒绝访问”和乱码先从 MySQL 端查坑一PyMySQL 连接 MySQL 8 报Access denied for user rootlocalhost现象明明密码没错但pymysql.connect()就是报 1045 错误有时候还提示Authentication plugin caching_sha2_password cannot be loaded。原因MySQL 8 默认的认证插件是caching_sha2_password而一部分旧版本的 PyMySQL 或 MySQLdb 只支持mysql_native_password。有些课程设计源码是两年前写的用的还是老连接库自然就卡住了。解决先在 MySQL 里执行下面这条 SQL把认证方式改掉然后再运行 Flask 程序。ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码; FLUSH PRIVILEGES;如果你是下载资源里自带的旧版 PyMySQL也可以直接升级pip install -U pymysql cryptography升级后两种认证都支持。我建议两条路都走一遍反正都是免费方案能让你少折腾不少。坑二数据库和页面中文全部变成问号现象页面表格里的“高等数学”显示成“???”MySQL 命令行里查出来也是乱码。原因建表时用了默认字符集或者连接参数里没写charsetutf8mb4而本机 MySQL 默认字符集又不是 utf8mb4。课程设计里最容易出现这种问题因为 Windows 上安装 MySQL 经常会选latin1作为默认编码。解决回到init_db.sql把CREATE DATABASE语句后面的DEFAULT CHARSET utf8mb4好好检查一遍。同时在db.py的DB_CONFIG里必须写charset: utf8mb4。如果库已经建错了用下面的语句改掉ALTER DATABASE campus_assistant CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;改数据库字符集不会自动更新已存在的表所以表也统一改一下把courses、tasks、notes分别执行ALTER TABLE xxx CONVERT TO CHARACTER SET utf8mb4。这步做完删除旧表重新执行init_db.sql是最干净的方案因为课程设计初期没有真实数据重建成本很低。5.2 接口与运行环境外键、session、端口三个高频翻车点坑三Jinja2 页面渲染时突然 500提示TypeError: NoneType object is not subscriptable现象登录后进到 dashboard 页面浏览器报内部服务器错误命令行日志显示TypeError定位到模板里某个字段取不到值。原因很大概率是任务表里有一条数据的course_id指向了不存在的课程或者 JOIN 查出来的结果里course_name是NULL。下载包里如果自带测试数据有些测试数据的user_id是 1但当前登录用户是 2列表虽然查到了空结果模板里却对空列表做了t[0]操作。解决先在 MySQL 里手动执行 JOIN 查询确认返回结果里有没有NULL。然后回到模板把t[title]这种取数方式改成t.get(title, )或者在路由里做一层默认值处理。我的习惯是模板里只用{% for t in tasks %}加{{ t.get(title, ) }}这是 Django 和 Flask 模板引擎都支持的写法能避开一大批空值问题。坑四登录成功后刷新页面又退回登录页session 总是失效现象用户在浏览器里明明点了登录跳转到 dashboard 了但按一下 F5 就回到 login 页或者浏览器开着程序重启后全部需要重新登录。原因主要是app.secret_key的问题。如果代码里写成app.secret_key os.urandom(24)每次 Flask 进程重启都会生成一个新签名密钥旧 session 全部失效。有些源码写app.secret_key Flask 同样无法稳定签名。解决把secret_key写死成一段固定字符串比如campus-assistant-2024。就算代码公开也没关系课程设计项目的安全级别不用太高保持 session 稳定比临时改一个随机密钥更重要。另外开发服务器要开启app.run(debugFalse)有的同学为了看报错把debugTrue一直开着debug 模式下的调试器会干扰 session 的读取这也是一个隐藏因素。坑五Address already in useFlask 5000 端口或 MySQL 3306 端口被占用现象运行python app.py时终端提示端口被占用服务起不来或者 MySQL 命令行能连但 Flask 报名称为本地端口已使用。原因Windows 上可能是之前一次课程设计残留的 Python 进程还占着 5000 端口也可能是 MySQL 装了两份3306 被第一个实例占住。解决先用netstat找到占用端口的 PID然后决定是杀掉进程还是换端口。netstat -ano | findstr :5000 taskkill /PID 这里写PID /F如果不想杀进程就改 Flask 启动端口比如app.run(port5001)。MySQL 端口冲突则需要去my.ini里改port3307同时修改db.py的DB_CONFIG中port。课程设计交付时最好在 README 里写清楚“默认端口是 3306如果冲突请改哪几个文件”这个细节很容易被答辩老师当作加分项。6. 别急着交用自动化冒烟测试和 Waitress 跑一个能演示的稳定版本6.1 冒烟测试脚本不点页面也能验证核心链路演示前最怕的是手忙脚乱点错按钮。我习惯先写一个冒烟脚本把所有核心功能自动跑一遍确认没问题之后再打开浏览器给老师演示。这个脚本基于 Python 的requests库模拟真实 HTTP 请求。# smoke_test.py import requests BASE http://127.0.0.1:5000 s requests.Session() # 1. 登录 login_resp s.post(f{BASE}/login, data{ username: admin, password: 123456 }, allow_redirectsTrue) assert 我的任务 in login_resp.text, 登录后页面没有出现任务关键字 # 2. 查看任务列表 dashboard_resp s.get(f{BASE}/dashboard) assert Python in dashboard_resp.text, 任务列表里没有课程信息 # 3. 新增任务 task_resp s.post(f{BASE}/task/add, data{ title: 冒烟测试任务, course_id: 1, due_date: 2024-12-30 }) assert task_resp.status_code 200 print(冒烟测试通过)脚本里有三个断言覆盖登录、查询、写入三个关键动作。注意course_id要和数据库里的课程 ID 对应如果你在课程表里插的数据 ID 不是 1改成实际值。allow_redirectsTrue是为了让requests跟随 Flask 的redirect到 dashboard。登录后的 session 由requests.Session()自动保持和浏览器行为一致。在命令行跑python smoke_test.py如果输出“冒烟测试通过”基本可以放心演示。如果失败看断言的具体位置是登录失败、列表没有数据还是新增失败然后再回到对应路由排查。6.2 用 Waitress 替代 Flask 开发服务器演示时不卡壳Flask 自带的开发服务器会在控制台打印一堆请求日志而且并发能力很弱演示时一旦有老师打开 F12 连续刷新页面可能卡住。更专业的做法是用 Waitress 做生产级服务器它是纯 Python 实现的 WSGI 服务器Windows 上安装使用都非常稳定。pip install waitress waitress-serve --port8000 app:appapp:app的含义是“从 app.py 中导出名为 app 的 Flask 实例”。如果你把app Flask(__name__)写在一个叫main.py的文件里命令就要改成main:app。启动后访问http://127.0.0.1:8000效果和开发服务器一样但没有那些Debugger: active的提示更适合作为一个正式版本来演示。用 Waitress 时要注意它默认监听127.0.0.1如果需要在机房其他电脑上访问加参数--listen0.0.0.0:8000。课程设计演示通常是自己电脑上连投影屏不需要开外部访问所以默认即可。另外Waitress 不处理静态文件的优化但校园学习助手项目静态文件很少完全不需要折腾 Nginx。我还养成了一个习惯每次演示前先跑一遍smoke_test.py确认核心链路通了之后再用 Waitress 启动服务。以前我拿到课程设计源码总想直接点开就展示结果遇到 session 失效、中文乱码、端口占用各种问题只能在讲台上现场改代码。从那以后我每次交课程设计都会强制走一遍“MySQL 建库 → 初始化数据 → 冒烟测试 → Waitress 启动”的完整流程确认没有玄学问题才截图希望帮到你。本文还有配套的精品资源点击获取