Python 轻量级 Web 框架 Flask 入门与基础应用

2 快速实现 Flask 网页-DIY

在此之前需要安装 Flask 的依赖包，在终端执行：(开发环境推荐：Pycharm、VS Code)

pip install Flask

2.1 简单实现

下面快速实现一个简单的网页：

首先创建一个 app 实例对象，通过 @app.route() 绑定指定 url 与对应的视图函数：

from flask import Flask

# 创建一个 Flask 实例对象
app = Flask(__name__)

''' user 在网站上访问了下面的地址，后端将自动执行相应的函数，函数的返回值将在浏览器渲染 '''
# http://127.0.0.1:5000 -> 执行 index
@app.route("/")
def index():
    return "Hello World!"

# http://127.0.0.1:5000/login -> 执行 login
@app.route("/login")
def login():
    return "Please Login in!"

if __name__ == '__main__':
    app.run()

运行效果：terminal 会显示网页地址及端口号，访问指定网址以及前面定义好的路径，可以看到函数的返回值就显示在浏览器当中。

另外，可以在代码 app.run() 中自行指定访问地址以及端口号。

2.2 Request

🌴request 对象 是一个全局上下文对象，它包含了客户端发送给服务器的所有 HTTP 请求信息。

要使用它，需要先从 flask 模块中导入：

from flask import request

下面是 request 对象中最常用的属性及其应用场景详解：

(1) 获取请求参数（Query Parameters）

通常我们在访问页面会看到这样的情况：.../index?age=21&pwd=123

后半部分实际上是用户传递的参数，在用户登录成功界面通常会如此显示。

在 Flask 当中通过 request 完成这种功能，通常用于 GET 请求，即 URL 中 ？ 后面的部分。

# http://127.0.0.1:5000/search -> 执行 search
# http://127.0.0.1:5000/search?keyword=flask 框架&pwd=1 -> 执行 search
@app.route('/search')
def search():
    keyword = request.args.get('q') # 获取 'q' 的值
    page = request.args.get('page', default=1, type=int) # 带默认值和类型转换
    print(f"Searching for {keyword} on page {page}")
    return f"Searching for {keyword} on page {page}"

运行效果：终端输出搜索关键词及页码，浏览器显示对应内容。

(2) 获取表单数据 (Form Data)

用于处理 HTML <form> 提交的 POST 请求。

🎥补充：GET VS POST

GET 和 POST 是 HTTP 协议中最常用的两种方法，决定了数据如何从客户端（浏览器/APP）传递到我们的 Python 后端。

— — 核心区别对照表：

— — 🌾🌾🌾 更加形象的理解：信封与明信片

GET - 明信片：信息写在背面，所有人（路由器、浏览器历史、中间代理）都能看到，它适合传递不敏感的小信息，比如'我要看第 5 页的内容'；

POST - 信封：信息封装在信封里面。虽然看不见内容，但如果不给信封加密（使用 HTTPS）,坏人还是可以拆开看。它适合传递敏感信息（如密码）或大宗信息（如上传文件）。

由于 POST 传递的数据形式是请求体，无法在代码中模拟出来，下面借助一个调试 API 的行业标准工具 — — Postman，可以用它模拟 POST 请求，并对应到代码逻辑。

@app.route('/login', methods=['POST'])
def login():
    # 从请求体中获取表单字段
    username = request.form.get('username')
    password = request.form.get('password')
    return f"用户 {username} 尝试登录"

运行效果：Postman 发送 POST 请求后，Flask 返回用户名。

🌗 **混合模式：**一个函数处理两种请求

在 Flask 实际开发中，我们通常把'显示页面（GET）'和'提交数据（POST）'写在同一个路由里：

@app.route('/contact', methods=['GET', 'POST'])
def contact():
    if request.method == 'POST':
        # 处理提交的表单
        msg = request.form.get('message')
        return "感谢您的反馈！"
    # 如果是 GET，则渲染并返回联系表单页面
    return render_template('contact_form.html')

(3) 获取 JSON 数据 (JSON API)

表单数据也可以以 json 形式传递，在现代前后端分离开发（如 Vue/React）或 AI 接口调用中常见。

Postman 操作方式：点击红框的位置：raw-JSON，输入 JSON 格式的数据。

点击 Send，后台数据并 login 函数似乎没有接收到这个信息？No，接收到了，但需要用匹配的形式 request.json.get() 获取。

(4) 获取文件上传 (Files)

处理用户上传的图片、音频等。

@app.route('/upload', methods=['POST'])
def upload_file():
    f = request.files['photo']
    f.save('./uploads/' + f.filename)
    return "File uploaded!"

2.3 视图函数的返回值

🎋 在前面的练习中我们返回的都是一个字符串，实际上，它们最终都会被 Flask 转换成一个响应对象（Response Object）。Flask 非常灵活，它允许返回多种格式的数据。

(1) 常见的返回类型

A. 字符串（String/HTML）

最简单的返回方式，Flask 会将其自动包装成一个状态码为 200、内容类型为 text/html 的响应。

@app.route('/')
def index():
    # return "Hello Flask!"
    return "<h1>Hello Flask!</h1>" # 浏览器会直接渲染 HTML

B. 字典与列表（自动转 JSON）

有时候我们返回的虽然是字符串的形式，在 Flask 开发中，json.dumps() 和 jsonify() 都能把 Python 对象转成 JSON 格式。

🌟区别在于：前者是 Python 标准库提供的序列化工具，而后者是 Flask 框架特有的响应工具。

a) json.dumps() ——'转换器'

负责把 Python 的字典/列表变成一个符合 JSON 格式的字符串。

b) jsonify ——'打包员'

Flask 专门为 Web 开发设计，不仅做了序列化，还帮用户把'货'装进符合 HTTP 规范的'箱子'。

实际开发中，jsonify() 更为推荐，因为它支持直接传入多个命名参数，具有更强兼容性，并自动处理一些安全漏洞（如 JSON 注入攻击）。

在 Flask 2.0+ 版本中，如果返回一个 dict 或 list，Flask 会自动调用 jsonify()。并将其 Content-Type 设置为 application/json，这是编写 API 接口最常用的方式。

C. 元组（Tuple） — — 自定义状态码

如果用户想控制 HTTP 状态码（例如返回 404 或 201），可以使用元组格式：

（响应体，状态码，响应头）

@app.route('/error')
def error_demo():
    # 返回内容，状态码
    return "页面未找到", 404

@app.route('/created')
def create_data():
    # 返回内容，状态码，响应头字典
    return {"msg": "创建成功"}, 201, {"X-Custom-Header": "Flask-Demo"}

(2) Flask API 简单实现

在前面学习的基础上，我们可以简单实现一个 Flask API 开发的小案例，逻辑简单：

案例说明：这是一个典型的 API 签名生成服务——接收 Client 传来的字符串，通过特定的算法进行加密后（MD5 + 盐），返回结果。

import hashlib
import json
from flask import Flask, request, jsonify

# 创建一个 Flask 实例对象
app = Flask(__name__)

@app.route("/bili", methods=["POST"])
def bili():
    ordered_string = request.json.get('ordered_string')
    if not ordered_string:
        return jsonify({"status": False, "error": "参数错误 1"})
    
    # 调用算法，处理接收到的数据
    encrypt_string = ordered_string + "123456789"
    obj = hashlib.md5(encrypt_string.encode('utf-8'))
    sign = obj.hexdigest()
    
    return jsonify({"status": True, 'data': sign})

if __name__ == '__main__':
    app.run()

运行效果：API 返回包含 status 和 data 字段的 JSON 响应。

😎 加密算法：

a) 加盐（Salting）：在原始字符串后拼接一个固定字符串。在计算机安全领域中称作'加盐'，目的是防止彩虹表攻击（即简单的 MD5 被破解）。

b) MD5 哈希：.encode('utf-8')：将字符串转为字节流，因为 hashlib 处理的是二进制数据。hashlib.md5(...)：创建 MD5 对象。.hexdigest()：将哈希结果转为常用的 32 位十六进制字符串。