UEditor 这玩意儿,做过老一点 Web 项目的人都不陌生。百度出品,功能全,界面也还算周正,当年不少后台管理系统都拿它当富文本编辑器用。但新手第一次碰它,最容易卡在同一个地方:编辑器里敲了半天字,点保存,数据到底怎么进数据库?有人直接把 HTML 塞进 varchar 字段,结果没两天就报错;有人存进去了,取出来一渲染,样式全乱。这事儿看着简单,真动手全是坑。

先说最核心的一点:UEditor 提交的内容是一段 HTML 字符串,不是纯文本。你在编辑器里加粗、换行、插图片、调表格,最终都会变成一堆带标签的代码。比如你写一句“今天天气不错”,加个粗,实际提交到后端的是 。所以后端接收到的就是一个长字符串。问题在于,这个字符串的长度可能远超你的想象——一篇稍微排过版的技术文章,HTML 源码轻松超过 2 万字符,如果里面还嵌了 base64 图片,直接飙到几 MB 也很正常。
数据库字段类型选不对,后面全是麻烦。MySQL 里 最大 65535 字节,但注意是字节不是字符,utf8mb4 编码下中文一个字占 3 到 4 字节,实际能存的中文也就一万多字。UEditor 的内容稍微长一点就爆了。 类型上限 65535 字节,也不够稳。真正靠谱的是 ,上限 1670 万字节左右,存普通富文本内容绰绰有余。 当然更大,但除非你要把整个网站的页面都塞进一个字段,否则 MEDIUMTEXT 完全够用,别浪费空间。字段类型这事儿,一开始选对了,后面省心;选错了,迁移的时候哭都来不及。
接下来说后端接收。UEditor 默认通过表单 POST 提交内容,字段名一般是 ,具体看你前端怎么配。Java 那边用 Spring MVC 的话,Controller 里一个 就拿到了。但这里有第一个坑:如果你的项目配了 XSS 过滤器或者 Spring Security 的 CSRF 防护,UEditor 提交的 HTML 可能被转义或拦截。XSS 过滤器会把 之类的标签干掉,这没错,但它有时候会把正常的 也一起处理了,导致存进数据库的内容缺胳膊少腿。解决办法是给保存接口单独配白名单,或者用 注册一个自定义编辑器,只做转义不做删除。
第二个坑是编码。UEditor 默认提交的编码是 ,如果你的 Tomcat 没配 ,或者 Spring 的 没生效,存进去的中文就是一堆问号。这个问题在本地开发时不容易发现,因为 IDE 内置的 Tomcat 通常默认就是 UTF-8,一部署到正式服务器就原形毕露。检查方法很简单:保存一段中文,去数据库里 出来看看。如果是乱码,先查过滤器,再查数据库连接串有没有加 。
图片处理是另一个大分水岭。UEditor 支持两种图片插入方式:一种是远程链接,,这种存起来轻量,但外链一失效,文章里的图就全挂了;另一种是本地上传,UEditor 会把图片传到后端配置的路径,返回一个服务器地址。绝大多数项目用的是第二种。但注意,UEditor 默认的图片上传接口是它自带的 ,生产环境基本没人直接用,都是自己重写上传逻辑。重写的时候要记住:上传成功后返回的 JSON 格式必须符合 UEditor 的要求,,少一个字段前端就报错。
存进去之后,取出来渲染也有讲究。如果你在后台管理界面直接 或者 输出,HTML 会正常渲染,但 XSS 风险也跟着来了。攻击者完全可以在 UEditor 里切到源码模式,插一段 ,你存进数据库,下次任何人打开这篇文章,脚本就执行了。所以取出来渲染之前,必须过一遍白名单过滤。Java 里常用 Jsoup 的 ,Python 里用 ,Node 里用 。配置白名单的时候,把 这些放行, 之类的全部干掉。这样既保住了排版,又堵住了漏洞。
还有一类容易被忽略的情况:UEditor 的内容里可能包含用户自己粘贴的 Word 文档。从 Word 里复制过来的内容,HTML 里全是 这种带命名空间的脏标签,直接存数据库,前端渲染时浏览器虽然能容错,但样式会莫名其妙地跑偏。更麻烦的是,这些脏标签会让 HTML 长度暴增两三倍。解决办法是在保存之前做一次清洗,用正则或者 Jsoup 把 开头的标签和属性全部剥掉,只留干净的语义化标签。这一步做了,数据库字段压力小,前端渲染也稳定。
说一个实际项目里的取舍:要不要把 UEditor 的内容分表存?如果你的系统文章量在十万级以下,单表一个 MEDIUMTEXT 字段完全扛得住。但如果文章量到了百万级,而且每篇内容都很大,主表的查询性能会被拖累——因为 MySQL 读取行的时候,TEXT 类型的数据不一定会跟其他字段一起加载,但 的时候一定会。这时候可以考虑把内容字段拆到单独的 表,主表只存标题、作者、时间这些元数据,详情页再用 去关联查询。这样列表页的查询速度会快很多,详情页稍微慢一点,但整体是划算的。
绕了一圈回到开头那个问题:UEditor 保存到数据库,核心就三件事——字段类型选 MEDIUMTEXT,后端接收注意编码和过滤,前端渲染之前做 XSS 清洗。这三步每一步都有坑,但每一步都有成熟的解决方案。别想着一步到位,先把内容存进去,再考虑安全,优化性能。顺序对了,问题就少一半。


