自建 ONLYOFFICE 踩坑实录：25MB Word 为何能让服务器和浏览器双双崩溃？

最近我们频繁收到用户反馈：

• “我的 Word 文件才 20MB / 25MB，并不大，为什么打不开？”
• “有时提示服务器限制，有时浏览器直接崩溃，这是怎么回事？”

一、常见问题现象

1. 提示服务器限制

“文件大小超出了为服务器设置的限制，请联系管理员”

2. 浏览器直接崩溃

• 页面卡死
• 标签页自动关闭
• Chrome 提示 “Aw, Snap!”

二、一句话结论

这些问题几乎都不是“文件大小”本身导致的，而是文档在解析和渲染过程中，占用的“实际内存”远远超过文件大小。

三、为什么 25MB 会“变成几百 MB”？

很多用户的直觉是：文件 25MB → 运行时也是 25MB。但真实情况并非如此。

1. Word 本质是“压缩包”

.docx 文件实际上是一个 ZIP 压缩包，里面包含：

• 文本（XML）
• 图片
• 样式
• 嵌入对象（Visio、Excel 等）

25MB 只是压缩后的体积，解压后可能达到 100MB ~ 500MB+。

2. 浏览器里不是“文件”，而是“对象”

在 ONLYOFFICE 中，浏览器需要：

• 解析 XML
• 构建文档结构
• 计算排版
• 渲染页面

这一步会极大放大内存占用：

1MB 文档 ≈ 5MB ~ 20MB 内存

因此：25MB 文件 → 几百MB甚至上GB内存

3. 浏览器有“生存机制”

浏览器为了不被拖垮，会限制：

• 单标签页内存（通常 1GB ~ 2GB）
• CPU 使用

一旦超限，浏览器会主动关闭页面或直接崩溃。

四、真正的关键：不是大小，而是“复杂度”

决定文档是否能打开的，是内容复杂度，而不是文件大小。

1. 高清图片（最常见）

• 图片压缩后：2MB
• 解码后：可能 20MB+

如果有几十张图片，内存会直接爆炸。

2. 嵌入对象（OLE）

例如 Visio 图、Excel 表、PDF 等。这些对象会被解析或转换，极其消耗内存和 CPU。

3. 修订记录（Track Changes）

一个段落可能包含多层历史版本，结构复杂度呈指数级增长。

4. 复杂排版

例如多层嵌套表格、文本框、自动目录等，会导致排版计算极其复杂。

5. 字体问题

缺失字体或使用非标准字体，会导致多次重排，性能下降。

五、为什么会出现“两种不同报错”？

情况一：服务器限制报错

提示“文件大小超出限制”，本质是服务端主动拒绝处理，属于保护机制。

情况二：浏览器崩溃

本质是浏览器内存撑爆，被强制关闭。

六、如何解决？

场景一：提示“文件超出服务器限制”

可以通过修改配置来放宽限制。

配置文件路径 /etc/onlyoffice/documentserver/default.json

示例配置

json

{
  "inputLimits": [
    {
      "type": "docx;dotx;docm;dotm",
      "zip": {
        "uncompressed": "500MB",
        "template": "*.xml"
      }
    },
    {
      "type": "xlsx;xltx;xlsm;xltm",
      "zip": {
        "uncompressed": "300MB",
        "template": "*.xml"
      }
    },
    {
      "type": "pptx;ppsx;potx;pptm;ppsm;potm",
      "zip": {
        "uncompressed": "500MB",
        "template": "*.xml"
      }
    }
  ]
}

修改后重启服务

bash

supervisorctl restart all

或（Docker 环境）：

bash

docker restart onlyoffice-documentserver

注意事项

• 这只是“放宽限制”，并不能解决所有问题
• 文档复杂仍可能崩溃
• 配置过大可能拖垮服务器

场景二：浏览器崩溃

推荐从“文档优化”入手：

1. 压缩图片（最有效）
2. 删除不必要修订记录
3. 优化嵌入对象
4. 拆分大文档

七、总结

问题的本质不是“文件有多大”，而是“文件有多复杂”。

八、给用户的快速判断方法

如果你的文档：

• 图片很多
• 包含 Visio / Excel 嵌入对象
• 有大量修订记录

即使只有 10MB，也可能打不开。

结语

如果你在使用 ONLYOFFICE 过程中遇到类似问题：

不要第一时间怀疑“文件不算大，为什么打不开”，而应该考虑：

• 文档是否过于复杂
• 是否需要优化或转换

相关资源

• OnlyOffice 最新版本 9.x 镜像：https://onlyoffice.moqisoft.com/docs/install/docker
• 版本介绍：https://onlyoffice.moqisoft.com/docs/product/summary