应使用os.path.realpath获取真实绝对路径后，用os.path.commonpath([real_path, allowed_base]) == allowed_base校验是否在授权目录内；仅字符串操作无法防御编码绕过或符号链接攻击。
用 os.path.realpath + 白名单目录比对才是可靠方案
仅靠字符串操作（比如 os.path.basename、replace 或正则过滤 ".."）无法防御路径遍历。因为这些方法不解析路径语义，对 ../../../etc/passwd 会返回 "passwd"，拼接后仍能向上穿越；对 URL 编码的 %2e%2e%2f 或双斜杠 .// 同样失效。
真正有效的做法是：让操作系统归一化路径，再确认它是否落在允许的目录内。
-
os.path.realpath(user_input)解析所有..、.、符号链接，返回真实绝对路径 - 用
os.path.commonpath([real_path, allowed_base]) == allowed_base判断是否在白名单目录内（注意不能用startswith，因 Windows 大小写不敏感、UNC 路径等边界情况） - 必须在拼接前校验，而不是读取后检查文件名
os.path.join 的陷阱：它不会阻止路径穿越
很多人误以为 os.path.join("static/files", "../../../etc/passwd") 会“安全拼接”，其实它返回的是 "static/files/../../etc/passwd" —— 这个字符串本身合法，但传给 open() 时就会穿越出去。
更危险的是 os.path.join("/a", "/b") 直接返回 "/b"，第二个参数如果是绝对路径，前面所有内容都被丢弃。
立即学习“Python免费学习笔记（深入）”；
- 永远不要把用户输入直接喂给
os.path.join后就信任结果 - 若必须拼接，先对用户输入做
os.path.normpath归一化，再走realpath + commonpath校验流程 - Flask 的
send_file()不自动做路径校验，需手动防护
解压场景下要用 tarfile.extractall(filter="data")
Python 3.14+ 中 tarfile 支持 filter 参数，默认值 "data" 已内置防御逻辑：清除开头斜杠、拒绝绝对路径、规范化软链接目标、剥离危险权限位。
旧版本（zipfile.ZipFile 没有内置 filter，必须遍历 namelist()，对每个 name 调用 os.path.normpath 并检查是否越界。
- 不要用
extract()或extractall()直接解压不可信归档 - ZIP 场景示例：对每个
info.filename做os.path.realpath(os.path.join(target_dir, info.filename))，再与target_dir比对 - 即使用了
filter="data"，也要确保target_dir是绝对路径且已resolve()
Pathlib 方式：用 Path.resolve() 和 relative_to()
pathlib.Path 提供更清晰的语义，但同样不能跳过归一化和范围校验步骤。
错误写法：Path("static/files") / user_input —— 这只是字符串拼接，没做任何安全控制。
- 正确流程：先
user_path = Path(user_input).resolve()，再base_path = Path("/var/www/static").resolve() - 用
user_path.relative_to(base_path)校验，抛出ValueError表示越界（这是最简洁可靠的白名单判断） - 注意：如果
user_input是空字符串或纯..，resolve()可能返回父目录，必须配合relative_to()才有效
realpath 或 resolve() 的方案，都等于没防。 
