IIIF实现（Loris+Mirador）中Mirador图片加载报错问题咨询

报错常见成因及排查方案 #

1. Manifest中图片服务ID配置错误 #

这是最高概率的问题：你报错信息中请求的瓦片路径为philhist-papyri-01.philhist.unibas.ch/6%2Fimages%2F6.VersoUnidentifiedLiteraryText-IR.jpg/full/4,/0/default.jpg，但你给出的可正常访问的图片路径前缀带有/loris/段，说明你在Manifest里配置的画布对应的图片服务@id（IIIF 2.x版本）/id（IIIF 3.x版本）字段缺失了/loris/前缀，Mirador拼接瓦片地址时自动省略了该段，导致请求路径不匹配，浏览器加载失败中止。

2. Loris跨域配置异常 #

如果你的Mirador部署域名和Loris服务域名不一致，且Loris未配置对应的CORS跨域规则，浏览器会主动拦截瓦片请求，也会抛出加载中止的报错。你可以打开浏览器开发者工具的「网络」面板，查看对应瓦片请求的状态和报错信息，如果明确提示CORS跨域错误，即可确认是该问题。

3. 瓦片参数配置不匹配 #

如果Manifest中声明的tiles字段（瓦片尺寸、缩放级别等）和Loris服务支持的参数范围不匹配，Loris会拒绝对应瓦片请求，也会触发该报错。

排查步骤 #

• 手动测试瓦片路径：把报错的请求路径前加上/loris/段，直接在浏览器访问，如果可以正常加载图片，即可确定是Manifest的图片服务ID配置错误，修改Manifest生成逻辑补全路径前缀即可。
• 校验Manifest合法性：使用IIIF官方的Manifest校验工具检查资源字段配置，确保每个画布关联的图片服务ID是完整的Loris路径。
• 检查Loris配置：确认配置文件中uri_prefix参数设置为/loris/，cors_allow_origin参数允许Mirador所在域名访问，测试阶段可临时设置为*验证是否为跨域问题。
• 核对瓦片参数：确认Manifest中声明的瓦片尺寸、缩放级别和Loris配置的支持范围一致。

内容的提问来源于stack exchange，提问作者Fatjon Lala