做后台开发的兄弟,十有八九都跟Ueditor打过交道。这玩意儿功能是真全,从加粗字体到传视频传图片,一套下来跟个小型Word似的。但爽归爽,每次把编辑器里的内容往数据库里一塞,麻烦事儿就来了——要么存进去的时候好好的,读出来全成了乱码和一串串看不懂的转义符;要么样式全丢了,排版稀碎,用户辛辛苦苦排的版,刷新页面直接回到解放前。今天这篇,咱们就专门聊聊Ueditor保存数据库这条路上,最常见的两个坑:防转义和格式丢失,到底怎么填平。

先说转义这回事儿。很多人第一次遇坑,是往数据库里存了一段带HTML标签的内容,比如,结果存进去变成了。看着数据库里那堆鬼画符,第一反应是Ueditor出问题了,其实不是。这是PHP或者Java那边做了一层默认的转义处理,把尖括号、引号全变成了HTML实体。这么做本意是防SQL注入,但用在富文本上就尴尬了,因为富文本本身就是HTML,一转义等于把内容阉割了。处理办法很简单,入库前对内容做一次反转义,或者干脆在接收数据时,针对富文本字段跳过那层过滤,用或者这类函数把内容还原。但这里有个前提,你得搞清楚框架到底在哪一步动了手脚,别盲目反转义,否则反而可能把原本安全的字符搞坏。
再来说格式丢失,这坑比转义还隐蔽。你辛辛苦苦在编辑器里插了张图,设置了居中、加了边框,存进数据库后再读出来,图片还是那张图,但居中和边框全没了。问题出在Ueditor默认的过滤规则上。它有一套白名单机制,专门清洗不认识的标签和属性。比如属性里的某些样式,或者、这种,如果不在白名单里,直接给你删了。所以你存进去的内容,其实已经是“阉割版”,跟你在编辑器里看到的不是一回事。解决思路有两个:一是修改Ueditor的配置文件,在里面调整或者关闭过滤,但这招风险大,万一用户粘贴了恶意脚本,你等于自己把门打开了。二是更稳妥的做法——入库前拿编辑器内容做一次完整快照,别依赖它输出什么就存什么,而是自定义一套保存格式。
说到自定义保存,就绕不开一个经典方案:存HTML,但存的是“净化后”的HTML。什么意思呢?你在前端拿到Ueditor的内容后,先别急着提交,用DOMPurify这类库跑一遍,把危险的标签和属性全干掉,但保留正常的排版样式。然后再提交到后端,后端再存库。这样既防了XSS,又保住了格式。但这里还有个细节,DOMPurify默认也会过滤掉部分内联样式,比如你给文字加了个,可能就被清了。所以你得在DOMPurify的白名单里显式加上你需要的样式属性,比如本身,或者特定标签的特定属性。说白了,安全跟格式之间,你得自己找平衡点,默认配置永远是偏保守的。
格式丢失还有一种情况,不是被过滤,而是被“截断”了。比如你把内容存进了VARCHAR字段,长度限制255个字符,内容一长,后半截直接被数据库砍了。等你读出来,页面排版烂了一半,图片没了,段落错位。这种问题其实最好排查,但往往最容易被忽略。很多人排了半天错,才发现是表结构的问题。解决办法简单粗暴:把字段类型改成TEXT或者MEDIUMTEXT,甚至LONGTEXT,看你的内容体量来定。但改字段之前,记得先看一下现有数据有没有被截断的,如果有,得先补数据,不然改完类型,旧数据还是缺的。
还有一个坑,是前端提交时Ueditor自动做的转义。有些版本在返回的内容里,会把部分字符转义掉,比如变成,空格变成。你如果不做处理直接存,数据库里存的就是转义后的内容。下次读出来再用Ueditor的回显,编辑器能识别,但如果你是用纯文本方式展示,比如放到邮件里或者导出PDF,那这些转义符就会原样显示出来,特别难看。所以稳妥的做法是,入库前用拿纯文本,或者用拿HTML后,再统一做一次标准化的反转义,确保存库里的是干净的HTML源码,而不是带实体编码的内容。
说到回显,还有一个经常被忽略的细节:Ueditor在编辑已有内容时,如果内容里带了标签或者,它默认会帮你过滤掉,因为编辑器有安全设置。但这意味着,你之前存的内容里如果有视频嵌入代码,比如优酷或者YouTube的iframe,存进去没问题,但再打开编辑时,iframe被编辑器干掉了,用户一保存,视频就没了。这个问题很隐蔽,得在里把和的过滤规则放开,或者把嵌入视频的功能改成用图片占位,编辑时点击图片再弹窗修改视频地址。别指望Ueditor默认配置能面面俱到,它更多是出于安全考虑,牺牲了部分灵活性。
那到底怎么设计一套靠谱的保存方案?我建议分三步走。第一步,前端拿到内容后,先用DOMPurify清洗一遍,把危险的脚本、事件属性全干掉,同时保留你需要的样式和标签。第二步,把清洗后的内容用或者Base64编码一下再提交,后端收到后再解码存库,这样能避免传输过程中HTTP协议层面的字符干扰。第三步,数据库字段用LONGTEXT,字符集用utf8mb4,确保表情符号、生僻字都能存得下。这套流程下来,基本能保证你存进去什么,读出来还是什么,不会多一层转义,也不会少一段样式。
提醒一句,别迷信框架自带的过滤机制。Laravel有函数,ThinkPHP有,这些默认的防XSS手段都是针对普通字符串的,用在富文本上就是灾难。正确做法是在后端单独开一个富文本接收通道,不走常规的输入过滤,而是走白名单清洗逻辑。你可以自己写一个简单的HTML净化器,也可以用现成的HTMLPurifier库,虽然性能差一点,但胜在稳。把富文本入库这件事当成一个独立模块来做,别跟普通表单字段混在一起,这样维护起来也省心。
说到底,Ueditor本身没问题,问题出在大家对它的输出太放心了。它给你的是“编辑器视角”的内容,不是“数据库视角”的内容,中间那层转换逻辑,得你自己补上。下次再遇到格式丢了、转义乱码,别急着骂编辑器,先想想你这套流程里,到底哪一层该放行却没放行,哪一层该清洗却没清洗。把这层窗户纸捅破了,Ueditor入库这事儿,也就那么回事儿。


