# 错误代码

当WCPOS遇到问题时，它会显示一个错误代码，帮助识别问题。每个错误代码遵循格式`[DOMAIN][CATEGORY][SPECIFIC_CODE]`，以帮助您快速了解错误的类型和性质。

## 错误代码格式[​](#error-code-format "直接链接到 错误代码格式")

| 组件         | 描述       | 示例                    |
| ------------ | ---------- | ----------------------- |
| **域**       | 系统区域   | `API`、`DB`、`PY`、`SY` |
| **类别**     | 错误类别   | `01`、`02`、`03` 等     |
| **具体代码** | 唯一标识符 | `001`、`002`、`003` 等  |

**示例：** `API04001` = API（域）+ 04（响应错误）+ 001（无效的响应格式）

***

## 错误域[​](#error-domains "直接链接到 错误域")

### [API错误](/zh-CN/error-codes/api.md)[​](#api-errorsapi "直接链接到 api-errorsapi")

当与您的WooCommerce服务器通信时，会发生API错误。

| 类别           | 代码范围 | 描述                             |
| -------------- | -------- | -------------------------------- |
| 连接           | API01xxx | 网络和连接问题                   |
| 认证           | API02xxx | 登录、令牌和权限问题             |
| 请求           | API03xxx | 发送请求的问题                   |
| 响应           | API04xxx | 服务器响应的问题                 |
| 插件/WordPress | API05xxx | WordPress或WooCommerce插件的问题 |
| 配置           | API06xxx | 设置和配置问题                   |

### [数据库错误](/zh-CN/error-codes/db.md)[​](#database-errorsdb "直接链接到 database-errorsdb")

在本地存储或检索数据时，会发生数据库错误。

| 类别 | 代码范围 | 描述                   |
| ---- | -------- | ---------------------- |
| 连接 | DB01xxx  | 数据库连接和事务问题   |
| 数据 | DB02xxx  | 记录和约束问题         |
| 查询 | DB03xxx  | 查询语法和数据类型问题 |

### [支付错误](/zh-CN/error-codes/py.md)[​](#payment-errorspy "直接链接到 payment-errorspy")

在结账和支付处理期间，会发生支付错误。

| 类别 | 代码范围 | 描述             |
| ---- | -------- | ---------------- |
| 卡片 | PY01xxx  | 支付卡问题       |
| 网关 | PY02xxx  | 支付网关通信问题 |

### [系统错误](/zh-CN/error-codes/sy.md)[​](#system-errorssy "直接链接到 system-errorssy")

系统错误与设备资源和系统配置有关。

| 类别 | 代码范围 | 描述                 |
| ---- | -------- | -------------------- |
| 资源 | SY01xxx  | 内存、磁盘和权限问题 |
| 服务 | SY02xxx  | 配置和服务可用性     |

***

## 快速参考[​](#quick-reference "直接链接到 快速参考")

寻找特定错误代码？使用侧边栏导航到域，或直接搜索代码。

| 域                               | 总代码数 | 常见问题                   |
| -------------------------------- | -------- | -------------------------- |
| [API](/zh-CN/error-codes/api.md) | 39 代码  | 服务器通信、认证、插件问题 |
| [DB](/zh-CN/error-codes/db.md)   | 9 代码   | 本地数据存储和检索         |
| [PY](/zh-CN/error-codes/py.md)   | 6 代码   | 支付处理                   |
| [SY](/zh-CN/error-codes/sy.md)   | 5 代码   | 设备资源和配置             |

***

## 需要更多帮助？[​](#need-more-help "直接链接到 需要更多帮助？")

如果在遵循故障排除步骤后仍然遇到问题：

1. 检查 [故障排除](/zh-CN/support/troubleshooting/response-error.md) 部分以获取更详细的指南
2. 加入我们的 [Discord社区](https://wcpos.com/discord) 寻求支持
3. 在 [GitHub](https://github.com/wcpos) 上报告问题

***