Python 接口参数校验需在请求入口嵌入多层约束，覆盖类型、范围、格式及业务规则，使用框架声明式校验（如 FastAPI 的 Pydantic、DRF 的 Serializer），敏感字段仅做基础格式验证并脱敏，避免副作用、信息泄露与数据库查询。
Python 接口参数校验是保障数据安全的第一道防线，核心在于“提前拦截非法输入”，而非依赖 后端 逻辑兜底。校验不等于简单判断非空，需覆盖类型、范围、格式、业务规则等多层约束，同时避免暴露敏感信息或引发安全风险。
校验要嵌入请求入口，别等进业务逻辑再处理
使用框架（如 FastAPI、Flask-RESTful、Django REST Framework）的声明式校验机制，把校验逻辑放在 路由 层或序列化层，而不是在视图函数里手写 if 判断。这样既统一管理，又防止遗漏。
- FastAPI：直接用 Pydantic 模型定义字段类型、默认值、约束（min_length=1, max_length=50, ge=0, le=100, regex=r’^[a-zA-Z0-9_]+$’）
- Django REST Framework：用 Serializer 的 validators 和field-level validation方法，避免在 view 中重复校验
- 自定义装饰器（如 Flask）：可封装通用校验逻辑，但需确保错误响应统一返回 400 及明确的错误字段提示，不泄露内部结构
敏感字段必须脱敏校验，禁止明文参与规则判断
密码、身份证号、手机号等字段，校验重点不是“内容是否合法”，而是“是否符合基本格式 + 长度 + 是否已哈希 / 加密”。切勿在校验阶段解密或正则匹配明文敏感内容。
- 手机号：用 re.match(r’^1[3-9]d{9}$’, phone) 校验格式即可，不查归属地、不调第三方接口
- 密码：只校验长度（如 8–64 位）、是否含大小写字母 / 数字 / 符号（可选），绝不校验明文强度（如是否含生日）
- 身份证号：仅做基础格式（15/18 位、末位校验码）验证，不解析出生日期或地区码用于业务逻辑
避免校验引发副作用或信息泄露
校验过程本身不能改变数据状态，也不能返回过于具体的错误原因，防止被用于探测系统细节。
立即学习“Python 免费学习笔记（深入）”；
- 不要返回“用户名已存在”和“邮箱 已注册”两种不同提示——统一为“该账户已被注册”
- 不要因校验失败触发日志记录完整参数（尤其含 token、密钥），应脱敏后记录，如“api/login: user=’u_****’ failed validation”
- 避免在参数校验中调用数据库查询（如“检查用户名是否唯一”）——这类应归入业务层，并加缓存与限流
配合输入规范化，减少校验盲区
校验前先做标准化处理，能显著提升鲁棒性。比如去除首尾空格、统一 编码、转义特殊字符（但注意：HTML 转义应在渲染层，不在校验层）。
- 字符串字段：自动 strip()，再校验长度；对富文本字段，限制 HTML 标签白名单而非简单过滤 script
- 数值字段：int/float 转换失败时抛出 ValidationError，不静默转 0 或 None
- 时间字段：统一接收 ISO 格式（如 2024-01-01T12:00:00Z），拒绝时间戳或中文日期字符串
