Modrinth 下载时出现「CORS 错误」—— 含义与解决方法

错误现象

你会看到类似这样的提示： 「Access to fetch at ... has been blocked by CORS policy.」 转换随即中止，或跳过受影响的模组。

什么是 CORS

CORS（跨源资源共享）是浏览器的一项安全规则，用于阻止网站随意抓取其他域名的数据。Modrinth 的 CDN 明确允许跨源下载，但部分第三方模组托管站点不允许。

转换器是怎么处理的

转换器会先尝试直接抓取。如果被 CORS 拦截，就退而通过公共的 CORS 放行代理转发请求。速度较慢，但大多数情况下能成功。

如果备用方案也失败了

方案 A —— 手动下载出问题的模组

转换器会显示被拦截的是哪个 URL。在新标签页中打开它，保存 JAR 文件，再手动放进转换后 ZIP 的 mods/ 文件夹里来玩整合包。

方案 B —— 改用原生支持 .mrpack 的桌面启动器

Prism Launcher、Modrinth App 和 ATLauncher 不受 CORS 限制，因为它们不是浏览器。如果某个模组在浏览器里怎么都转不了，改用原生启动器即可。