应使用os.path.realpath获取真实绝对路径后，用startswith()检查是否在授权目录内；需防范符号链接绕过，禁止用户创建软链或逐级校验父路径。
用 os.path.realpath 校验真实路径是否在白名单内
直接拼接用户输入和基础目录是路径穿越的根源。比如 os.path.join("/var/www/static", "../../../etc/passwd") 会得到 /var/www/static/../../../etc/passwd，但这个字符串本身不触发穿越——真正危险的是你用它去 open() 或 Path.read_text()。必须让系统解析出它最终指向哪。
正确做法是：先拼接，再调用 os.path.realpath() 获取归一化后的绝对路径，最后用 .startswith() 检查是否落在授权目录下。
-
os.path.realpath()会处理..、.、符号链接（symlink），返回操作系统实际访问的路径 - 白名单必须是绝对路径，且需对
BASE_DIR同样调用os.path.realpath()再比对，否则 symlink 可能绕过 - 不要省略
realpath(BASE_DIR)这一步：如果/var/www/static本身是软链指向/mnt/data/static，而你只检查是否以/var/www/static开头，攻击者构造的路径可能绕过校验
别信 os.path.basename，它根本挡不住 ../
os.path.basename("../../etc/passwd") 返回 "passwd"，不是 "etc/passwd"，更不是 "/etc/passwd"。它只是按最后一个 / 切字符串，不做任何路径语义解析。
常见错误是把它当“安全过滤”用：
立即学习“Python免费学习笔记（深入）”；
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
filename = request.args.get('file')
safe_name = os.path.basename(filename) # ❌
with open(f'/var/www/static/{safe_name}') as f: # 实际打开 /etc/passwd
return f.read()- URL 解码后，
%2e%2e%2fetc%2fpasswd也会变成../../etc/passwd，basename依然只取passwd - Windows 下的
..\、%5c（反斜杠 URL 编码）同样无效 - 空字节
\x00截断、双写绕过（如....//）会让所有基于字符串的过滤失效
用 pathlib.Path.resolve() 替代手工拼接（Python 3.6+）
pathlib 的 .resolve() 是 os.path.realpath() 的面向对象等价物，语义更清晰，且自动处理当前工作目录、符号链接和路径归一化。
示例（Flask 场景）：
from pathlib import Path
<p>BASE_DIR = Path("/var/www/uploads")
user_input = request.args.get("file", "")</p><p>try:
full_path = (BASE_DIR / user_input).resolve()
if not full_path.is_relative_to(BASE_DIR):
raise PermissionError("Access denied")
return send_file(full_path)
except (FileNotFoundError, PermissionError):
abort(404)-
.is_relative_to()比.startswith()更安全：它基于路径对象比较，不依赖字符串前缀，能防住某些边界 case - 注意：
.resolve()在路径不存在时会抛FileNotFoundError，所以必须包裹在 try/except 中 - 如果用户输入含
~（home 目录），.resolve()会尝试展开，这可能引入非预期行为；生产环境建议禁止~和绝对路径开头（如/、C:\）
Web 框架内置函数不是万能的
Flask.send_from_directory()、Django.serve()、FastAPI.FileResponse() 确实做了基础防护，但仅限于它们直接接管文件路径的场景。一旦你手动用 open()、Path.read_bytes() 或 shutil.copyfile() 处理用户输入的路径，所有框架层防护就失效了。
- 常见疏漏：在
send_from_directory()前加日志记录，日志里又拼了一次路径；或为支持 zip 下载，先解压到临时目录再读取——解压过程若没校验 tar 包内路径，就会触发 CVE-2025-4330 类漏洞 - Python 3.14 默认启用
tarfile.open(..., filter="data")，但该 filter 有已知绕过（CVE-2025-4330），不能替代路径校验 - 上传文件时，不仅读要校验，写也要校验：
shutil.move(user_uploaded_file, os.path.join(BASE_DIR, filename))中的filename同样可能含../
路径穿越修复的关键不在“怎么切字符串”，而在“操作系统最终访问的是哪”。哪怕用了最新 Python 版本、最成熟的框架，只要路径校验逻辑缺失或被绕过，漏洞就存在。
