如果安装后小组件没有显示,几乎总是以下三种情况之一:已上线的页面中没有代码片段、页面被缓存,或内容安全策略阻止了脚本加载。
确认代码片段已上线
打开已发布的网站,查看页面源代码,并搜索 accessibird。如果找不到,说明更改未保存或未部署。请在 CMS 中重新发布,或再次推送代码更改。
绕过缓存
浏览器和 CDN 会大量缓存 HTML 和脚本。使用 Ctrl+Shift+R(Mac 上使用 Cmd+Shift+R)强制刷新。如果使用了 Cloudflare 等 CDN,还需要清除该页面的 CDN 缓存。
检查内容安全策略
如果网站发送了严格的 Content-Security-Policy 响应头,你可能需要在 script-src 和 connect-src 中允许 accessibird.com。打开浏览器控制台;如果脚本被阻止,控制台会明确报告,调整策略以放行相应资源即可解决。
通过测试页面验证
控制面板中的小组件测试页面会在不受其他因素干扰的环境中加载小组件。如果小组件在测试页面上正常运行,但在你的网站上无法运行,说明问题出在网站上,而不是 Accessibird。
从你自己的网站加载
小组件的请求必须直接来自你自己的网站。Localhost 和预览地址不会被计入“活跃”或“已验证”状态,因此请在已上线的网站上检查。
