issue: PDF export produces a completely black page for long chats

快速结论：该问题通常出现在用 Open WebUI 的「Chat menu → Download → PDF Document (.pdf)」导出较长对话时，PDF 变成整页全黑、文字和图片不可读。优先排查的是对话长度/附件规模触发的导出渲染失败，而不是 UI 主题问题。

适用环境：Open WebUI v0.9.6；安装方式 Docker (docker compose) 与 Git Clone 均有报告；CentOS 8.5；Google Chrome 149.0.7827.103，Microsoft Edge 也可复现。

最快修复方案：暂无确认的一步修复方案。Issue 被标记为 duplicate 并已关闭，讨论中未给出经过验证的官方修复步骤。

注意事项：切换 Dark/Light 主题无效，浏览器自带「Print → Save as PDF」也无效，因此不要在这两个方向上耗费时间。该问题仅在长对话中复现，短对话有时正常，说明与内容体量相关；请以 Issue 后续更新或合并后的目标 Issue 为准。

问题场景

用户在 Open WebUI 中打开一个较长的对话（消息数量多、单条消息长，且 spesso 带有图片附件），通过聊天菜单选择「Download → PDF Document (.pdf)」导出。对话在浏览器中显示正常，但导出的 PDF 为完全黑页，没有任何可读文本或图片。短对话有时可以正常导出。

报错原文

issue: PDF export produces a completely black page for long chats

When exporting a chat to PDF via Chat menu → Download → PDF Document (.pdf),
the exported PDF for long conversations comes out as a completely black page,
with no readable text or images.

- For short conversations, the PDF export sometimes works correctly.
- For long conversations (many/long messages, often with image attachments),
  the resulting PDF is entirely black.
- This is not related to the UI theme — it happens with both Dark and Light themes.
- Using the browser's own "Print → Save as PDF" on the chat page does not help either.

原因分析

Issue 本身没有给出明确的根因，官方也未在该讨论中确认具体修复。根据已关联的 Issue 判断，可能原因是：导出管线在处理大体量对话内容（长消息、图片附件、复杂对话结构）时渲染失败，导致生成全黑输出。相关 Issue #18334 报告了「大聊天历史无法成功下载为 PDF、生成空白页」，指向与对话长度/体积相关的导出失败；#23393 报告了 Notes 导出 PDF 出现黑底，说明同一渲染栈在其他导出流程中也会产生黑页现象。因此「长对话触发渲染异常」比「主题颜色导致黑底」更符合现有证据。

环境排查

Open WebUI 版本是否为 v0.9.6 或更新（Issue 报告为 v0.9.6）。
安装方式：Docker (docker compose) 还是 Git Clone，两者均有相关报告。
操作系统：报告环境为 CentOS 8.5。
浏览器：Google Chrome 149.0.7827.103；Microsoft Edge 也可复现。
触发条件：确认是否为长对话、是否包含图片附件或复杂对话结构（多模型对话等）。
确认 PDF 导出是否走内置「Download → PDF Document (.pdf)」，并记录浏览器自带打印是否同样失败。

解决步骤

先确认问题是否符合已知特征：仅长对话出现全黑页，短对话可正常导出，且 Dark/Light 主题下均复现。满足则大概率是同一个导出渲染问题。
检查 Open WebUI 是否为最新版本；Issue 被标记为 duplicate 并关闭，说明可能已有重复 Issue 在跟踪，需到相关 Issue 中确认是否已有合并后的修复或版本更新。
作为规避手段，可优先尝试拆分或分段导出：将长对话拆成多个较短会话，或在导出前减少单条消息的长度与图片附件数量，再尝试导出 PDF。此方法为基于「短对话有时正常」现象的推测性规避，并非 Issue 中已验证的修复。
不要依赖切换主题或浏览器自带「Print → Save as PDF」作为解决方案，Issue 已确认这两者均无效。
如需进一步定位，保留导出失败的完整对话信息（消息数量、附件类型、导出时段），并关注官方在重复 Issue 中给出的后续处理结论。

验证方法

用同样的长对话重新执行「Download → PDF Document (.pdf)」导出，检查生成的 PDF 是否不再是纯黑页、文字和图片是否可读。若仍为黑页，则说明当前版本尚未包含修复；若短对话与长对话均能正常导出，才算问题解决。注意：Issue 讨论中未提供官方验证过的补丁，以上仅为确认现象是否消失的方法。