HTMLPurifier通过白名单机制默认剥离onerror等事件属性,正确做法是按标签粒度配置HTML.Allowed(如'a[href|title],img[src|alt]'),禁用全局属性列表,配合FORBIDDEN_ELEMENTS增强防护。

HTMLPurifier 怎么禁掉 onerror 但保留 href 和 src
onerror 不是独立存在的“漏洞”,它是 HTML 元素的事件属性,只要没被白名单显式允许,就该被自动剥离。关键不是“怎么禁”,而是“别让它进白名单”。HTMLPurifier 默认不放行任何 on* 属性,但一旦你配置了宽松的 HTML.AllowedAttributes,比如写成 'href, src, title'(没限定标签),它就会把 script[src]、img[onclick] 全放进来。
正确做法是按标签粒度声明属性:
-
HTML.Allowed设为'a[href|title], img[src|alt], p, br, strong, em'—— 竖线|表示“只允许这些属性”,且绑定到指定标签 - 绝对不要写
HTML.AllowedAttributes = 'href, onclick'这类全局配置,否则iframe[onclick]也能过 - 显式加
HTML.ForbiddenElements = ['script', 'object', 'embed', 'applet'],双重保险
DOMPurify 配置里 FORBID_ATTR 能否覆盖 onerror
能,但有前提:必须配合 FORBID_TAGS 和协议校验,否则只是纸面安全。比如只写 FORBID_ATTR: ['onerror', 'onclick'],攻击者仍可构造 或 (后者在 DOMPurify 默认配置下已被拦截,但若你关了 SAFE_FOR_TEMPLATES 就可能漏)。
推荐最小可行配置:
FORBID_TAGS: ['script', 'iframe', 'object', 'embed']FORBID_ATTR: ['onerror', 'onclick', 'onload', 'onmouseover']-
ALLOWED_URI_REGEXP: /^https?:\/\//i(强制 href/src 只能是 http/https) - 别依赖
ADD_ATTR增加新属性,除非你清楚每个值的语义边界
bluemonday 中 UGCPolicy 为什么 still 有 onerror 漏洞
它没有。bluemonday.UGCPolicy() 默认禁用所有事件属性,包括 onerror。如果你发现清洗后仍有 onerror 存活,大概率是以下三种情况之一:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 你调用了
.AllowAttrs("onerror").OnElements("img")这类手动放行操作,直接绕过了预设策略 - 原始 HTML 里用了大小写混淆,如
ONERROR或OnError—— bluemonday 默认不忽略大小写,需显式配.AddUglyCase(true) - 你把清洗结果又拼进了模板变量,比如
{{ template.HTML(cleaned) }},而 cleaned 实际是未清洗的原始字符串(常见于变量名拼错或 handler 层漏调Sanitize())
为什么不能靠正则替换 onerror= 来解决
因为浏览器解析 HTML 不靠正则。你写 str.replace(/onerror=/gi, ''),攻击者立刻换种写法:、、。这些都能绕过简单字符串匹配,且仍被浏览器执行。
真正起作用的是 HTML 解析器重建 DOM 的过程——它会把整个 HTML 字符串 parse 成节点树,再按白名单逐个判断是否保留。这也是为什么 strip_tags()、htmlspecialchars()、手写正则三者全都不适合富文本场景。
最容易被忽略的一点:白名单过滤必须发生在服务端入库前,且只能做一次。重复净化可能损坏 Unicode 字符(比如把 © 变成 © 再变回 ©),导致前端显示异常或搜索失效。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










