性能调优
优化渲染和内存
Doconut 的资源概况主要由三件事主导:渲染 DPI、缓存内容和会话持续时间。本指南按影响顺序介绍这些杠杆。
分辨率 — 最大的杠杆
ImageResolution(25–300 DPI)决定渲染时间和图像大小。大多数格式默认 200 DPI;图像和 PSD 默认 100。
// 文档列表预览不需要打印质量
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });将 DPI 减半大约会使每页像素数降低四分之一——渲染更快,传输更小,缓存内存更少。对需要大量缩放的使用场景(CAD、工程图纸)保留 250–300 DPI。
对于嵌入大量图像的 PDF,PdfConfig 提供更细的调节:CompressImages + CompressQuality、ResizeImages + ResizeResolution,以及 CompressFast。对于普通图像,ImageConfig.MaxImagePixelSize(默认 3000 像素)限制输出尺寸。
页面缓存 — 内存 与 重新渲染
BaseConfig.CachePages(默认 true)在会话期间将每个已渲染的页面保存在内存中。这是交互式查看的合适默认设置——用户可以前后滚动。当出现以下情况时请关闭:
- 文档体积庞大且仅查看一次,从头到尾,
- 多个并发会话会导致缓存页面数量成倍增加,
- 与其占用 RAM,不如为每次查看支付 CPU。
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });在客户端,ViewerConfig.CacheEnabled = true 会在浏览器内存中预加载即将显示的页面图像的一个小移动窗口。它是每次查看的预取缓存,而不是持久的 localStorage。
会话 — 你看不见的内存
每个打开的会话都会保存已解析的文档模型以及(使用 CachePages)其渲染页面,直至滑动窗口 TimeOut(默认 60 分钟)在自上次请求以来到期。以下两种做法可保持控制:
- 关闭已完成的会话。
viewer.CloseDocument(token)会立即释放引擎,而不是等待空闲窗口结束。 - 合理设置超时时间。 用户浏览两分钟的预览并不需要一小时的会话:
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });请记住权衡:过期后小部件会显示 Document session not found. Please re-open document. ——请选择与实际阅读会话相匹配的超时时间。
特定格式开关
- Excel:
MemoryOptimizationPreference默认 开启,在渲染超大工作簿时可降低内存占用——保持开启,或在想用少量内存换取一点速度提升时将其设为false;SheetNames/PrintArea限制渲染仅针对重要内容。 - 重定向模式有前置成本:
DefaultRender = false在打开时将整个文档转换为 PDF。它提供原生文本搜索,但在 500 页文档上,打开调用会承担该转换——不要盲目启用。 - 在没有文档字体的服务器上运行 Word/PowerPoint:没有 Office 的 Windows Server 所拥有的字体远少于开发机器。缺失的字体会导致缓慢的回退探测和错误的度量;请安装这些字体,或将
FontFolders指向包含它们的文件夹。
客户端策略
LargeDoc = true— 对超大文档的懒加载策略;页面在用户接近时加载。AutoLoad = false(默认)——在实际调用View(token)之前不进行渲染。ShowThumbs = false—— 对单页或嵌入式预览跳过缩略图生成/请求。- 启用
FixedZoom可避免自由缩放的变化;当你映射一个 C#ViewerConfig时,针对小屏幕调节FixedZoomPercentMobile(C# 默认 75)。
启动一次,而非每次请求
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) 应放在 Program.cs 中——每次请求注册编码是浪费的工作;完全忘记它会导致旧版代码页文档出错。
跨节点分担工作
上述所有内容都是对单节点按需渲染的调优。当单个节点无法承受负载时,下一个杠杆不是更大的调节,而是将文档的产物一次性发布到共享存储,让每个节点提供服务。这会改变成本模型:渲染每个文档只进行一次,而不是每个会话一次,页面请求变为文件读取。参见 分布式部署。
调优清单
- 将您的用户体验可接受的最低
ImageResolution设置为最小值。 - 对交互式查看保持
CachePages开启;在一次性或高并发场景下关闭。 - 明确关闭会话;在使用突发的情况下缩短
TimeOut。 - 对大文档在客户端使用
LargeDoc+ 默认的AutoLoad = false。 - 仅在需要带文本的 PDF 投影时使用
DefaultRender = false。
此页面对您有帮助吗?