FILE TROUBLESHOOTING

文件无法打开时,
应该先检查哪项上限

文件容量超限、解码后的像素过大、设计格式不兼容、浏览器缺少功能,以及矢量过于复杂,是五类不同的问题。本指南依据当前DrowPack的app.js数值与行为,给出不会绕远路的检查顺序。

发布于 2026-07-30依据当前app.js实现预计阅读 8 分钟
先按这个顺序检查

读取屏幕上的状态提示,然后按照格式 → 文件字节数 → 解码后的宽高 → 浏览器或网络 → 矢量复杂度逐步缩小范围。只改扩展名,或把同一个文件放进ZIP,并不会转换文件内容,也不会消除真正的原因。

当前实际执行的上限

DrowPack会分别检查上传文件的字节大小与图片解码后的像素尺寸。一个10MB的PNG可以通过第一项检查,但如果解码后超过64MP,仍会失败。相反,即使分辨率不高,只要PNG文件本身超过32MB,也会在上传阶段停止。

对象当前上限超限时的表现直接解决方法
PNG、JPG、WebP每个文件最大32MB提示图片文件过大降低像素尺寸,或清除无用元数据后重新导出
上传SVG每个文件最大8MB提示SVG文件过大清理未使用的path、元数据和隐藏对象,或改用PNG/WebP
PDF或AI每个文件最大40MB提示PDF/AI文件过大单独保存需要的第一页,或导出图片预览
解码后的普通图片每边最大16,384px,总计最大64MP提示图片分辨率过大同时降低最长边和总像素数
PDF/AI第一页渲染每边最大8,192px,总计最大12MP渲染倍率自动限制在该范围内如需更精细的细节,直接将目标画板导出为PNG或JPG

64MP指宽度乘以高度,而不是两边相加。12,000×5,000px等于60MP,并且没有超过单边16,384px,因此符合这两项条件。10,000×7,000px等于70MP,即使单边都不算过长,也会失败。请在文件属性或编辑软件的图片大小面板中同时查看这两个指标。

PDF和AI不会作为可编辑矢量直接打开

DrowPack只把PDF/AI的第一页渲染到白色背景的预览canvas中。后续图片输出与SVG转换都以这个渲染结果为来源。如果需要其他页面、原始图层或可控的栅格化精度,应先从编辑软件导出所需页面或画板。

避免无效尝试的诊断顺序

  1. 记录完整的状态提示。“文件过大”“分辨率过大”“没有PDF兼容数据”分别需要不同处理。
  2. 确认文件不是空的。0字节文件、尚未同步完成的云端占位文件、中断的下载,都需要重新下载或导出完整文件。
  3. 确认真实格式,而不只看扩展名。支持PNG、JPG/JPEG、WebP、SVG、PDF和兼容PDF的AI。把其他格式改名为.png不会改变编码。
  4. 将字节大小与上表比较。如果已经超限,更换浏览器也不会绕过该项验证。
  5. 对于栅格图片,检查解码尺寸。单边16,384px和总计64MP需要分别满足。高压缩文件在磁盘上可能很小,解码到内存后却非常大。
  6. 对于PDF/AI,检查兼容性和网络。AI必须包含PDF兼容数据。如果提示无法加载PDF渲染库,应先恢复网络访问后重试。
  7. 如果上传成功而输出失败,再降低工作复杂度。先减小预览canvas,再依次降低颜色、细节、小碎片和path数量。

按设计文件格式直接处理

AI:保存时包含PDF兼容数据

文件以.ai结尾,并不代表浏览器一定能读取。只有内部带有PDF兼容表示时,DrowPack才能打开它。请在Illustrator中启用PDF兼容选项重新保存,或把目标画板导出为PNG或JPG。“没有PDF兼容数据”表示文件内部缺少浏览器可读的PDF表示,并不是文件名写错。

PSD:导出合并后的预览图

DrowPack不能直接打开PSD原文件。请使用Photoshop或兼容编辑器,将当前可见合成结果导出为PNG、JPG或WebP后上传。需要透明背景时选择PNG或WebP;不透明的照片、绘画类图片通常更容易通过JPG降低容量。只把.psd改成.jpg并不等于导出。

PDF:确认第一页与渲染库

如果作品位于第二页或之后,请把该页另存为单页PDF,或导出成图片。出现“无法加载PDF渲染库”时,应先检查离线状态、网络拦截和浏览器扩展,再决定是否重做文件。一般性的渲染失败可能来自损坏数据,或浏览器无法读取的PDF结构;从原编辑软件重新保存成一个新PDF,是最快的对照测试。

SVG:区分8MB上传上限与页面预览保护

上传到DrowPack的SVG上限是8MB。新生成的纯矢量SVG在页面内显示时,还有一项更低的安全条件:当结果超过1,800,000字节(约1.8MB),或path超过9,000个,DrowPack会跳过页面内渲染,以防浏览器卡顿。生成的SVG数据仍然保留,下载功能依然可用。“已跳过预览”不等于转换失败。

白色细缝、白边噪点与过重矢量

这些现象看起来相近,但调整方向不同。请按100%比例查看结果,判断问题是相邻色块之间连续的细线、边缘散落的小白碎片,还是path过多导致整个页面变慢。

可见症状首先调整起效原因
填充色块之间出现白色细缝启用色块缝隙修正,将宽度调到0.8至1.0与fill同色的细stroke会覆盖path之间的渲染缝隙
轮廓出现小白点或白色碎片降低颜色数量,或提高小点移除减少抗锯齿中间色被追踪成独立path的数量
照片描摹生成的SVG非常大降低颜色数量与细节减少色块和边界,可同时降低path数与文件大小
标志或线稿出现不必要的复杂度改用标志或线稿专用模式,不使用照片描摹追踪条件更符合输入结构
复杂图片转成纯矢量后始终过重选择原始画质SVG或PNG/WebP无需用数千个可编辑path重建照片式纹理

原始画质SVG通过在SVG容器中保留栅格图片来维持外观,它与可按path编辑各个色块的纯矢量用途不同。path数量不是质量分数,应根据是否需要可编辑几何形状,还是需要稳定的视觉还原来选择。

SVGZ或ZIP下载失败时

SVGZ依赖CompressionStream

SVGZ是用gzip压缩的SVG文本。DrowPack使用浏览器的CompressionStream功能,因此缺少该功能时,SVGZ操作会不可用或提示不支持。压缩失败不会删除已经生成的矢量结果。正式的替代路径是下载普通SVG;它包含相同的矢量内容,只是没有gzip压缩,如有需要可稍后用其他工具压缩。

ZIP失败时先减小当前图片尺寸

创建上传包时,DrowPack会从当前预览canvas生成多张JPG;如果已有最新SVG,也会一并加入,然后在浏览器内存中组装ZIP。出现“ZIP创建失败”时,请先减小当前canvas尺寸,再重新创建。重复上传同一张大图或不断刷新,并不会减少所需内存。若重要SVG已经完成,应在改变canvas之前单独下载保存。

  • 关闭其他占用大量内存的标签页后,只重试一次
  • 把预览长边降低到实际发布所需尺寸
  • 对于巨大的纯矢量,减少颜色、细节和小path生成
  • 如果只有SVGZ失败,确认普通SVG能否下载
  • 刷新或切换浏览器之前,先保存已经完成的结果

重试前的30秒检查

  1. 判断失败阶段。先分清提示属于字节数、解码尺寸、格式、渲染还是输出。
  2. 核对数字。比较栅格32MB、SVG 8MB、PDF/AI 40MB,以及解码图片16,384px与64MP上限。
  3. 满足格式专属要求。AI使用PDF兼容保存,PSD导出为PNG/JPG/WebP,多页PDF分离出所需页面并放在第一页。
  4. 只有输入已能打开时,才降低复杂度。从canvas尺寸开始,再调整颜色数量与细节。
  5. 使用替代输出。SVGZ不可用时下载SVG;纯矢量不现实地沉重时,选择原始画质SVG或PNG/WebP。

完成这些检查后,如果仍然只有某个原文件失败,请保留原件,并从原编辑软件导出一个较小的测试副本。测试副本能够打开时,原因更可能是原文件的结构或规模,而不是浏览器本身。

文件正常打开后继续阅读

根据真正需要的输出,选择合适的SVG方式与质量设置。