怎样修复Python Web项目路径穿越漏洞-Python教程-PHP中文网

应使用os.path.realpath获取真实绝对路径后，用startswith()检查是否在授权目录内；需防范符号链接绕过，禁止用户创建软链或逐级校验父路径。

怎样修复python web项目路径穿越漏洞

用 `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)</p>

.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 版本、最成熟的框架，只要路径校验逻辑缺失或被绕过，漏洞就存在。