为何部署到托管服务后manifest.json无法获取或解析？

从托管环境下最容易出现的几个问题点入手排查：

1. 修正Manifest的MIME类型 #

多数托管服务（包括你用的Epizy）默认不会给manifest.json设置正确的application/manifest+json MIME类型，这会直接导致浏览器无法识别该文件。

• 若使用Apache环境，在站点根目录创建或修改.htaccess文件，添加：

  AddType application/manifest+json .json
  

2. 调整Start URL并补充Scope属性 #

你改成绝对URL反而容易引发路径匹配问题，PWA更推荐使用相对路径，同时补充scope明确作用范围：
修改manifest中的对应字段：

"start_url": "/?home=true",
"scope": "/",

这样既和本地环境保持一致，又能避免跨路径的权限问题。

3. 验证图标路径与文件权限 #

• 确认服务器上的icons文件夹结构、文件名和本地完全一致（Linux服务器区分大小写，本地Windows不区分，别在这里踩坑）。
• 直接在浏览器访问图标地址（比如https://puntotuzo.epizy.com/icons/manifest-icon-192.maskable.png），如果返回404，说明文件没传对或者路径写错了。
• 检查文件权限，确保manifest和图标文件是公开可读的（一般设置为644权限）。

4. 检查HTML中的Manifest引用 #

确认页面头部的引用标签路径正确，要指向根目录的manifest文件：

<link rel="manifest" href="/manifest.json">

如果manifest不在根目录，要对应调整href的相对路径。

5. 强制清除缓存后重新检测 #

托管后浏览器大概率缓存了旧资源，按Ctrl+Shift+R强制刷新页面，或者在Chrome DevTools的「Application」面板手动清除站点缓存，再用Lighthouse重新检测。

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