SVG文件特别危险是因为它本质是XML文档,支持、onload、href="javascript:..."等可执行上下文,浏览器渲染时会解析并执行其中JS,导致XSS;仅靠secure_filename或扩展名白名单无效,必须进行内容级校验——先限大小与MIME类型,再验XML头部签名,最后用XML解析器白名单清洗节点与属性。

不能只靠 secure_filename 或扩展名白名单来处理 SVG 文件——它本质是 XML,可嵌入脚本,必须做内容级校验。
为什么 SVG 文件特别危险
SVG 不是普通图片:它是 XML 文档,支持 <script></script>、onload、href="javascript:..." 等执行上下文。浏览器渲染时会解析并执行其中的 JS,导致 XSS。即使你用 secure_filename 重命名成 avatar.svg,只要内容没清理,用户访问该文件(比如通过 send_from_directory)就可能触发攻击。
常见错误现象包括:
- 上传一个带
<svg onload="alert(1)"></svg>的文件,后端返回 200,前端预览时弹窗 - 用
magic.from_buffer()检查 MIME 类型为image/svg+xml就放行,但实际内容含恶意 JS - 仅过滤文件扩展名(如只允许
.svg),却未阻止malicious.svg.jpg这类双扩展名绕过
必须做的三步校验
缺一不可,顺序不能颠倒:
-
第一步:限制上传大小 + 拦截非 SVG MIME —— 在 WSGI 层就拒绝超大或明显非法请求:
app.config['MAX_CONTENT_LENGTH'] = 2 * 1024 * 1024(2MB 足够 SVG);同时在路由开头快速检查request.files['file'].content_type != 'image/svg+xml',直接return {'error': 'Invalid content type'}, 400 -
第二步:读取前 N 字节做签名验证 —— SVG 必须以
<?xml或<svg> 开头(忽略空格和注释)。用 <code>file.stream.read(1024)获取头部,正则匹配r'^\s*,不匹配则拒收 -
第三步:XML 解析 + 白名单节点/属性清洗 —— 用
xml.etree.ElementTree解析(禁用外部实体),递归遍历所有元素,删除含on*、href(值含javascript:)、script、foreignObject的节点。不要用正则替换,XML 嵌套结构会让正则失效
保存与提供服务时的陷阱
即使校验通过,后续环节仍可能翻车:
安全 Python 代码沙箱:在隔离的沙箱中执行任意 Python 代码,预装 requests、NumPy、pandas 库。返回 stdout、stderr。
- 不要用
send_from_directory直接返回 SVG——它默认设置Content-Type: image/svg+xml,但浏览器可能根据响应体内容二次解析并执行 JS。应改用send_file并强制加安全头:headers={'Content-Security-Policy': "default-src 'none'; script-src 'none'"} - 存储路径必须是绝对路径且与 Web 根目录隔离,避免用户通过 URL 猜测路径直接访问原始文件
- 如果需预览,应在服务端转成 PNG(用
cairosvg库)再返回,彻底剥离 XML 上下文
真实可用的清洗示例(精简版)
import xml.etree.ElementTree as ET
from io import BytesIO
<p>def clean_svg_content(svg_bytes):
try:</p><h1>禁用外部实体,防 XXE</h1><pre class="brush:php;toolbar:false;"> parser = ET.XMLParser(resolve_entities=False)
root = ET.parse(BytesIO(svg_bytes), parser).getroot()
except ET.ParseError:
raise ValueError("Invalid SVG syntax")
# 递归清理危险属性和子树
def _clean(elem):
# 删除 on* 事件属性
attrs_to_drop = [k for k in elem.attrib if k.startswith('on')]
for k in attrs_to_drop:
del elem.attrib[k]
# 删除 javascript: href
if 'href' in elem.attrib and elem.attrib['href'].startswith('javascript:'):
del elem.attrib['href']
# 删除 script 和 foreignObject 元素
children_to_remove = []
for child in elem:
if child.tag == 'script' or child.tag == '{http://www.w3.org/2000/svg}script':
children_to_remove.append(child)
elif child.tag == 'foreignObject' or child.tag == '{http://www.w3.org/2000/svg}foreignObject':
children_to_remove.append(child)
else:
_clean(child)
for c in children_to_remove:
elem.remove(c)
_clean(root)
return ET.tostring(root, encoding='unicode')
注意:这个函数只处理内存中的 XML 结构,不保证 100% 防御所有 SVG 变种攻击(比如 base64 编码的内联 JS),生产环境建议配合 svg-sanitizer 这类专用库,并定期更新规则。
最易被忽略的一点:SVG 清洗必须在保存到磁盘前完成——一旦恶意内容落地,后续任何「按需读取+再清洗」都晚了;而且清洗后的字节流要重新校验长度,防止清洗过程引入意外空白或截断。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










