手机号掩码不能仅用re.sub(r'(\d{3})\d{4}(\d{4})', r'\1****\2', phone)，因未清理非数字字符、未校验长度、未锚定边界，易漏掩或误掩；应先提纯数字并验11位，再精准替换。
手机号掩码为什么不能只用 re.sub(r'(\d{3})\d{4}(\d{4})', r'\1****\2', phone)
这种写法看似能遮住中间四位，但实际会漏掉非标准格式的手机号：带空格、横线、括号、+86前缀，甚至混入中文字符（如“手机号：138-1234-5678”）。正则没做边界和清理，re.sub 会直接在原始字符串上匹配，导致部分场景替换失败或误伤。
实操建议：
- 先用
re.sub(r'[^\d]', '', text)提纯数字，再判断长度是否为 11 —— 避免对“1381234567”或“138123456789”错误掩码 - 掩码逻辑必须加
^和$锚定，或用\b防止匹配到长数字串中的子串（如身份证号里混着手机号） - 示例安全写法：
def mask_phone(text):<br> digits = re.sub(r'[^\d]', '', text)<br> if len(digits) != 11:<br> return text<br> return re.sub(r'^(\d{3})(\d{4})(\d{4})$', r'\1****\3', digits)
身份证号掩码要区分15位和18位，且末尾X必须保留大小写
15位身份证全是数字；18位末位可能是 X 或 x，这是校验码，不能转大写后硬替换成 *。直接用 text[:6] + '******' + text[-4:] 会出错：15位时 text[-4:] 取的是最后4位数字，但18位时末位是 X，若原文是小写 x 却被替成大写，就破坏了原始校验逻辑。
实操建议：
- 用
re.match(r'^\d{15}$|^\d{17}[\dXx]$', id_num)先校验格式，不匹配的原样返回 - 15位：掩码为
id_num[:3] + '******' + id_num[-3:] - 18位：掩码为
id_num[:6] + '******' + id_num[-4:]—— 注意id_num[-4:]自动包含原始大小写的末位 - 别用
str.replace()批量处理整个日志文本，它无法识别“上下文”，可能把订单号“11010119900307213X”里的19900307当作日期误掩
在 FastAPI/Flask 返回前统一掩码，别在数据库层或 ORM 模型里硬编码
把掩码逻辑塞进 Pydantic BaseModel 的 @validator 或 SQLAlchemy @hybrid_property，会导致同一字段在不同接口中行为不一致（比如导出 CSV 时不该掩码，但模型强制做了），也增加测试难度。
实操建议：
- 定义一个轻量函数
mask_sensitive_fields(data: dict, fields: list)，递归遍历字典/列表，只对明确声明的fields（如['phone', 'id_card']）做掩码 - 在 FastAPI 的
Response中间件或JSONResponse子类里调用；Flask 可用@app.after_request，但注意只处理Content-Type: application/json - 跳过
bytes、None、数字类型，避免TypeError: expected string or bytes-like object - 敏感字段名要支持嵌套路径，如
'user.profile.phone'，否则无法处理深层结构
日志中掩码手机号/身份证，得避开 URL 参数和 JSON Key
直接对整行日志用正则全局替换，会把 GET /api/user?phone=138****5678 里的 phone= 当作键名干掉，或者把 {"phone":"13812345678"} 的 key 也替成 {"****":"13812345678"}，导致日志无法解析。
实操建议：
- 用
re.sub(r'(? —— 利用前后界限定匹配位置 - 对 URL 查询参数单独处理：
urlparse解析后只掩码 value，再拼回去 - 日志掩码函数必须有开关（如环境变量
LOG_MASK_SENSITIVE=0），方便 debug 时临时关闭 - 别用
logging.Filter做复杂正则，性能差且异常时可能让日志丢失
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
