DZI Deep Zoom 图像查看器失败或结果异常？排错指南
排查DZI Deep Zoom 图像查看器的扩展名、文件结构、依赖、编码、内存和结果误差，同时保留原文件。
先保留原文件
不要改后缀后覆盖源文件，也不要把网页预览当成唯一验收记录。复制一份小样本并记录文件大小、来源软件、版本、浏览器和完整错误提示。
这个格式最容易忽略的事实
例如 sample.dzi 声明 256 瓦片、1 像素 overlap 和 100000×60000 尺寸。还必须能访问 sample_files/层级/x_y.jpg，单独 DZI XML 不是完整图像。
推荐排查顺序
- 使用页面示例或较小的已知正常文件，确认工具本身能够运行。
- 检查扩展名、文件签名、配套文件、远程 URL 和 CORS，排除下载到 HTML 错误页。
- 对照操作步骤重新提供输入：
- 选择 DZI XML 或填写公开描述符 URL。
- 检查 Format、TileSize、Overlap、Width 和 Height。
- 确认对应 _files 瓦片路径可以访问。
- 缩放检查边界、接缝、缺瓦片和最高层清晰度。
- 关闭占内存的标签页并使用最新版 Chrome 或 Edge 重试。
- 仍异常时回到生成文件的专业软件重新导出，在目标系统复核。
常见问题与答案
为什么只有空白画布？
最常见原因是 _files 瓦片目录不可访问、路径大小写错误或 CORS 阻止。
能把大图转成 DZI 吗？
当前工具只查看，不生成瓦片金字塔。
URL 会上传吗？
不会保存；浏览器会直接访问你提供的 DZI 和瓦片服务器。
不应绕过的限制
- 本地单个 DZI 不包含瓦片目录
- 远程查看受 CORS 和服务器权限影响
- 不生成 DZI 金字塔，也不修复缺失瓦片
隐私处理
本地输入不会为了处理上传到 FreeTool；远程 IIIF/DZI URL 会由浏览器访问来源服务器。排错截图、OCR 文本、模型摘要和转换文件可能包含敏感或受版权保护内容，分享前应脱敏并确认权限。