网页端客服窗口不显示,通常由代码未生效、资源被拦截或样式冲突导致。按下面的顺序排查,绝大多数情况可以在几分钟内解决。
先确认代码是否生效
在浏览器中查看页面源码,确认组件代码确实出现在最终渲染的页面里,而不是只在某个未发布的模板中。
- 查看网页源码是否含组件代码
- 确认代码添加在公用底部模板
- 清除缓存后重新验证
检查资源加载
打开浏览器开发者工具的控制台与网络面板,查看是否有脚本请求失败或被拦截。
- 查看控制台报错
- 检查脚本请求状态码
- 确认未被广告拦截插件屏蔽
排查样式与层级
窗口被其他元素遮挡或 z-index 冲突时看起来像"没加载",可临时提高层级验证。
- 检查是否被浮层遮挡
- 确认容器未被隐藏
- 在移动端检查响应式样式
常见问题
只在部分页面不显示怎么办?
通常是代码只加在了部分模板,把组件代码放到站点级公用模板中即可。
本地正常、线上不显示?
多为线上缓存或 HTTPS 混合内容问题,清缓存并确认页面为 HTTPS。