故障排查

import { Aside } from ‘@astrojs/starlight/components’;

故障排查

本页汇总了 Colvor 插件用户最常遇到的问题及解决方案。

授权问题

“授权码无效或未找到”

原因： 密钥可能含有多余空格，或输入有误。

解决方案：

1. 打开 Lemon Squeezy 购买确认邮件。
2. 使用 Ctrl+A 全选密钥字段中的文本。
3. 重新粘贴至 Colvor 授权输入框并点击激活。

“该域名已激活”

原因： 该授权已与另一个域名（或旧版本的同一域名）绑定。

解决方案： 登录 Colvor 账户中心，找到对应授权，点击旧域名旁边的停用，然后重新在当前域名上激活。

授权验证成功但插件显示“未激活”

原因： 本地缓存的验证结果已过期或损坏。

解决方案：

1. 进入 WooCommerce → 状态 → 工具。
2. 点击清除瞬态数据（transients）。
3. 重新加载 Colvor 设置页面。

---

插件冲突

激活后出现白屏（WSOD）

**请勿惊慌。** 白屏几乎都是由于 PHP 版本不兼容或插件冲突造成的，不会造成数据丢失。

解决方案：

1. 通过 FTP 临时停用所有其他插件（将 /wp-content/plugins/ 文件夹重命名）。
2. 单独激活 Colvor，确认其本身可以正常运行。
3. 逐一重新激活其他插件，找出冲突插件。

WooCommerce 钩子未触发

原因： 某主题或插件调用了 remove_all_actions() 或 remove_all_filters() 清除了 WooCommerce 钩子。

解决方案： 在 Colvor 设置中开启调试模式以获取详细日志，然后查看 WooCommerce → 状态 → 日志 中的钩子相关警告。

---

性能问题

授权验证导致高 CPU 占用

Colvor 使用 WordPress transients 在本地缓存授权验证结果，默认每小时才重新验证一次。如果你看到频繁的验证调用，可能是缓存插件过于激进地清空了 transients 缓存。

解决方案： 在缓存插件的清除规则中排除 Colvor 的 transients（前缀为 colvor_）。

---

仍然无法解决？

如果以上方案均无效，请在 GitHub 提交 Issue，并附上：

1. 你的 WordPress 和 WooCommerce 版本
2. 你的 PHP 版本
3. WooCommerce 状态日志（WooCommerce → 状态 → 日志）