# API04006: 资源未找到

## 这意味着什么[​](#what-this-means "直接链接到 这意味着什么")

服务器无法找到请求的资源。这通常对应于 HTTP 404 状态代码，表示您尝试访问的产品、订单、客户或其他资源不存在。

## 常见原因[​](#common-causes "直接链接到 常见原因")

* **记录已删除** — 资源在服务器上被删除
* **错误的 ID** — 使用了不正确或过期的 ID
* **同步问题** — 本地数据引用的资源已不再存在
* **URL 配置错误** — API 端点不正确
* **固定链接问题** — WordPress 固定链接需要刷新

## 服务器错误映射[​](#server-error-mapping "直接链接到 服务器错误映射")

当服务器返回以下内容时会触发此错误代码：

| 服务器代码      | 来源               |
| --------------- | ------------------ |
| `rest_no_route` | WordPress REST API |
| HTTP 404        | 任何服务器响应     |

## 如何修复[​](#how-to-fix "直接链接到 如何修复")

### 1. 检查资源是否存在[​](#1-check-if-the-resource-exists "直接链接到 1. 检查资源是否存在")

验证该资源在您的 WooCommerce 网站上仍然存在：

* 登录 WordPress 管理员
* 导航到相关部分（产品、订单、客户）
* 按 ID 或名称搜索项目

### 2. 刷新本地数据[​](#2-refresh-local-data "直接链接到 2. 刷新本地数据")

如果资源在服务器端被删除：

1. 打开 POS 设置
2. 导航到相关数据部分
3. 触发同步/刷新以更新本地数据
4. 被删除的项目应该在本地被移除

### 3. 检查 WordPress 固定链接[​](#3-check-wordpress-permalinks "直接链接到 3. 检查 WordPress 固定链接")

如果找不到多个资源：

1. 在 WordPress 管理员中转到 **设置 → 固定链接**
2. 点击 **保存更改**（即使不进行更改）
3. 这将刷新固定链接结构

### 4. 验证 API 路由[​](#4-verify-api-routes "直接链接到 4. 验证 API 路由")

直接测试 REST API：

```
https://yoursite.com/wp-json/wc/v3/products
```

如果返回 404，则可能存在服务器配置问题。

### 5. 检查插件冲突[​](#5-check-for-plugin-conflicts "直接链接到 5. 检查插件冲突")

如果缺少 REST API 路由：

1. 确保 WooCommerce 已启用
2. 确保 WCPOS 插件已启用
3. 暂时禁用其他插件进行测试

## 相关错误[​](#related-errors "直接链接到 相关错误")

* [API04001](/zh-CN/error-codes/API04001.md) — 无效的响应格式
* [API04002](/zh-CN/error-codes/API04002.md) — 意外的响应代码
* [API05002](/zh-CN/error-codes/API05002.md) — 找不到 WCPOS 插件

***