Flask 3.0 不执行运行时类型转换，request.args.get()等返回值恒为str或None；类型注解仅用于静态检查与文档，参数解析需显式处理（如Pydantic）或手动转换。
Flask 3.0 本身不提供运行时类型验证，type hints 在 Flask 中仅用于 IDE 补全、静态检查（如 mypy）和文档表达，不会自动拦截或转换请求数据。想靠 def handle_user(id: int, name: str) 就让 Flask 自动把字符串 "123" 转成 int、把空值转成 None？不行——这得靠你显式处理。
为什么 request.args.get() 返回的永远是 str 或 None
Flask 的 request 对象所有属性（args、form、json）返回的值都来自原始 HTTP 输入，底层是 werkzeug.datastructures.MultiDict，其 .get() 方法只做存在性查找，不做类型转换。即使你写了 user_id: int = request.args.get("id")，Python 运行时也不会报错，但 user_id 实际仍是 str 或 None，后续用它做算术或数据库查询就可能崩。
-
request.args.get("page")→ 返回"2"（str），不是2（int） -
request.json.get("active")→ 返回"true"或"1"，不是True（bool） -
request.form.get("score")→ 即使输入框填了95.5，拿到的仍是"95.5"
用 Pydantic v2 + Flask 3.0 做运行时验证
Flask 3.0 兼容 Pydantic v2（推荐 pydantic>=2.0），它是目前最实用的类型驱动验证方案。它能真正把 str 解析为 int、校验范围、处理缺失字段，并统一抛出 HTTPException。
示例：接收分页参数并强转为 int
立即学习“Python免费学习笔记（深入）”；
from flask import Flask, request, jsonify
from pydantic import BaseModel, ValidationError
from werkzeug.exceptions import BadRequest
<p>app = Flask(<strong>name</strong>)</p><p>class PageQuery(BaseModel):
page: int = 1
size: int = 20</p><p>@app.route("/items")
def list_items():
try:</p><h1>从 query string 构建模型，自动类型转换 + 验证</h1><pre class="brush:php;toolbar:false;"> query = PageQuery.model_validate(request.args)
except ValidationError as e:
raise BadRequest(e.errors(include_url=False))
return jsonify({"page": query.page, "size": query.size})
- 传
?page=abc→ 报 400，错误信息含具体字段和原因 - 传
?page=（空值）→ 使用默认值1 - 传
?page=-5→ 若加Field(ge=1)会拦截 - 不依赖
typing注解，而是靠BaseModel的运行时行为
别在视图函数签名里写 type hints 期待自动解析
下面这种写法看似“类型安全”，实则无效且误导：
@app.route("/users/<int:user_id>")
def get_user(user_id: str): # ❌ user_id 已被 Flask 路由转换为 int，这里写 str 反而让 mypy 报错
...
<p>def search(q: str, limit: int = 10): # ❌ Flask 不会读取这个 hint，limit 永远是 str
...
- 路径参数（
<user_id></user_id>）的类型转换由 Flask 路由系统完成，与函数注解无关 - 查询参数、表单字段、JSON body 的类型必须由你手动解析，
type hints不参与执行 -
mypy可以检查你写的int(user_id)是否合理，但不会帮你调用int() - 若坚持用注解作文档，建议只标注你实际使用的变量，比如
user_id: int = int(request.args["id"])
WTForms 和 Pydantic 怎么选
两者都能做验证，但定位不同：
-
WTForms：适合传统 HTML 表单提交（POST /form），带渲染支持、CSRF 集成、字段级 widget 控制；但对 JSON API 支持弱，语法冗长 -
Pydantic：原生适配 JSON、query、form 多种来源，类型表达力强（conint(gt=0)、EmailStr），错误结构清晰，与 FastAPI 生态一致；但不生成 HTML - Flask 3.0 项目若以 API 为主，直接用
Pydantic；若混合 HTML 页面，可 WTForms 处理表单，Pydantic 处理 API 接口
最易被忽略的一点：类型注解只是契约，不是执行逻辑。Flask 不会替你调 int()、datetime.fromisoformat() 或 json.loads() —— 那些都得你亲手写，或者交给 Pydantic 这类库来扛。
