理论课ch04配套实践:lab05_forms_and_upload(端口 5101)
第4章 与用户交互(表单与上传)
授课:谢福财 · 每个知识点按「是什么 → 生活案例 → 代码对照 → 易错点」四步讲,课后对照同章的实践课手册动手。
一、这节课要学会什么
- 分清 GET 与 POST 的语义
- 会用 Flask-WTF 定义表单并校验
- 理解 CSRF 是什么、为什么必须有
- 会做安全的文件上传
二、知识点逐个讲
1. GET 与 POST
GET 把参数放地址里,用来“取”;POST 把数据放请求体里,用来“交”。
生活案例:GET 是查快递(只看不改);POST 是寄快递(交了东西,状态变了)。
@app.route('/basic', methods=['GET','POST'])
if request.method == 'POST': ...
用 GET 做删除:浏览器刷新一次删一次。
2. Flask-WTF:把校验写清楚
表单类里声明字段和校验器,提交时 form.validate_on_submit() 一把校验完,错误信息回填到模板。
生活案例:报名表:姓名必填、年龄必须是数字——表本身写着规则,收表的人不用逐条问。
class BasicForm(FlaskForm):
name = StringField('姓名', validators=[DataRequired()])
score = FloatField('成绩', validators=[NumberRange(0,100)])
忘了 validators= 就永远校验不过。
3. CSRF:防“替你提交”
别人伪造一个表单让你的浏览器提交,Flask-WTF 要求表单里带一次性 token,没有就 400。
生活案例:银行取款要本人签名+身份证;token 就是这一次的签名,别人复制不走。
{{ form.csrf_token }} {# 表单里必须有 #}
删掉这一行会看到 400 The CSRF token is missing——这是保护在起作用。
4. 安全上传:三重校验
后缀白名单 + MIME 类型 + 文件大小,并且重命名后再存,避免覆盖和可执行文件。
生活案例:机场托运:先看是不是违禁品(类型),再看超没超重(大小),最后贴条码(重命名)。
fn = secure_filename(f.filename)
f.save(os.path.join(UPLOAD, fn))
只查后缀不够,文件名里的 ../ 会把文件写到别的目录。
5. 富文本与文件列表
CKEditor 把 textarea 变成可视化编辑器;文件列表读出 upload 目录内容展示。
生活案例:写公众号:不用记 Markdown,点按钮加粗、插图。
{{ ckeditor.load() }}{{ ckeditor.create() }}
富文本内容存库前要过滤脚本,否则有 XSS 风险。
三、课堂演示(本机实拍)

课堂演示:打开 lab05/app.py

课堂演示:运行面板 Running on 5101,提交表单可看日志
四、课堂练习
- 提交一个 101 分的成绩,看校验提示
- 上传一个 .txt 改名为 .png,看能否通过校验
- 在终端里看 POST 请求的日志行,指出状态码
做完对着实践课手册第六节的报错实战自查一遍:能自己看懂红字,才算真的会。
五、小结与下一节
本节要点:分清 GET 与 POST 的语义、会用 Flask-WTF 定义表单并校验、理解 CSRF 是什么、为什么必须有。
下一节:第5章:数据存下来——SQLAlchemy 与数据库迁移