**如果Papo聊天小部件（https://papo.global/）没有出现在您的网站上，诊断首先要检查代码片段是否正确插入到`</body>`标签之前，是否存在与缓存或优化插件的冲突，以及网站收件箱在Papo面板中是否保持活跃。本指南汇集了快速识别和修复故障的步骤。**

聊天小部件是将访客转化为对话的联系点。当它消失时，您会失去服务机会。好消息是，大多数故障都有简单的原因和快速的解决方案。

| 可能原因 | 快速检查 | 建议解决方案 |
| :--- | :--- | :--- |
| **代码片段缺失或位置错误** | 检查页面源代码（Ctrl+U），查找小部件脚本。 | 将代码片段重新插入到`</body>`闭合标签之前，与面板中生成的一致。 |
| **与缓存或优化插件冲突** | 在匿名/隐私窗口中测试网站，或暂时停用缓存插件。 | 将小部件脚本从压缩/缓存规则中排除，或在插入代码片段后清除缓存。 |
| **网站收件箱被移除或没有客服** | 转到**设置 → 收件箱**，检查类型为“网站”的收件箱是否列出并关联了客服。 | 重新创建收件箱并关联至少一名客服；复制新代码片段并更新网站。 |
| **脚本被浏览器扩展阻止** | 在其他浏览器中打开网站，或禁用活动扩展。 | 指导访客为该域名禁用脚本阻止程序，或检查网站的安全设置（CSP）。 |
| **与其他小部件或脚本冲突** | 检查浏览器控制台（F12）是否有JavaScript错误。 | 通过调整加载顺序或隔离脚本来解决冲突。 |

## 如何诊断小部件缺失

1. **确认代码片段在源代码中**  
   打开网站页面，右键单击并选择“查看源代码”（或使用Ctrl+U）。查找以类似`<script src="... app.papo.global ...">`开头的脚本。如果它没有出现，则代码片段未被添加或已被移除。

2. **在匿名/隐私窗口中测试**  
   通常，浏览器会缓存没有小部件的页面版本。打开匿名窗口会忽略本地缓存并加载网站的最新版本。如果小部件在该模式下出现，则问题是缓存，而不是脚本本身。

3. **检查浏览器控制台**  
   按F12打开开发者工具，转到“控制台”选项卡。红色错误可能表明小部件脚本被安全策略阻止或与页面上的其他脚本冲突。

4. **检查收件箱在Papo面板中是否活跃**  
   转到**设置 → 收件箱**。如果为网站创建的收件箱（类型“网站”）未列出，则可能已被意外删除。如果已列出，请检查是否至少关联了一名客服——没有客服的收件箱无法正确加载小部件。

## 如何修复最常见的问题

### 正确重新安装代码片段
如果代码缺失或位置错误，请重新执行该过程：
1. 在Papo面板中，转到**设置 → 收件箱**，点击**添加收件箱**并选择**网站**。
2. 为收件箱命名并输入网站URL。
3. 复制生成的脚本，并将其粘贴到所有应显示聊天的页面的HTML中，紧接在`</body>`闭合标签之前。
4. 将至少一名客服关联到收件箱并保存。

用新代码片段替换旧代码片段可确保在手动编辑中没有丢失任何字符。

### 处理缓存和优化插件
缓存插件、JavaScript压缩或延迟加载可能会阻止小部件脚本执行。如果您使用WordPress等平台，在添加代码片段后清除网站的所有缓存（服务器和插件）。如果可能，将小部件脚本从压缩规则中排除，或仅将其与基本脚本合并。在禁用所有优化插件的情况下进行测试有助于隔离原因。

### 重新创建收件箱并重新连接
当原始收件箱被移除或配置历史丢失时，最安全的方法是创建一个新的。过程与初始安装相同：创建类型为网站的收件箱，复制新代码片段并替换网站代码中的旧代码片段。然后，关联客服并检查小部件是否在匿名窗口中加载。在这种情况下，旧代码片段会自动停止工作。

## 本指南对谁有用

- **刚刚安装小部件但未看到它出现的公司**。
- **更改了主题或进行了网站更新并注意到聊天消失的运营团队**。
- **继承了已插入代码片段的网站并需要诊断小部件为何不加载的团队**。
- **希望避免因不可见的服务渠道而丢失潜在客户的人**。

## 常见问题（FAQ）

### 小部件只对我不可见，但我的客户能看到。为什么？
可能是您的浏览器缓存或您设备上的扩展程序阻止了脚本。在匿名窗口或其他设备上测试。如果小部件出现，则问题是本地的，不会影响访客。

### 我安装了代码片段，但小部件在特定页面上不显示。该怎么办？
检查代码是否粘贴到了为所有页面提供内容的模板中（例如WordPress中的`footer.php`），而不仅仅是单个页面。如果主题中有条件显示规则，可能需要调整它们以包含正确的域名。

### 我需要重新创建收件箱来修复小部件吗？
不一定。如果收件箱仍然存在并关联了客服，通常只需重新安装代码片段即可解决。当收件箱被删除或原始脚本丢失且无法恢复时，重新创建收件箱是替代方案。

### 我的网站使用WordPress，有什么需要特别注意的吗？
是的。缓存插件（如WP Rocket、W3 Total Cache）和压缩工具可能会阻止小部件脚本。清除缓存，暂时停用这些插件进行测试，如有必要，将小部件脚本从优化中排除。另请阅读关于WordPress安装的完整指南。

### 小部件之前出现，突然消失了。可能发生了什么？
网站主题更改、插件更新或服务器迁移可能会移除代码片段。也有可能网站收件箱已从Papo面板中删除。检查两种可能性：源代码和收件箱列表。

### 如何在不发布到正式网站的情况下测试代码片段是否正常工作？
您可以将脚本添加到测试环境中的测试页面或网站本身的隐藏页面。只要收件箱中提供的URL与插入脚本的域名匹配，小部件就会正常加载，供您验证。

## 另请阅读

- [如何在WordPress中嵌入Papo网站聊天](/hc/papo/articles/how-to-embed-papo-website-chat-in-wordpress)
- [如何检查您的频道是否在Papo中连接以及断开时该怎么办](/hc/papo/articles/check-channel-connection-status-papo-reconnect)

---

**[免费开始，几分钟内安装小部件 →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=chat-widget-not-showing-diagnose-fix-zh&utm_content=zh_CN)**

使用Papo，您可以直接在网站上提供支持，并将所有客服集中在一个面板中。