```
---

title: "API01004: DNS解析失败"

sidebar_label: API01004

---
```

# API01004: DNS解析失败

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

POS无法将您网站的域名（例如，`yourstore.com`）转换为IP地址。DNS（域名系统）就像互联网的电话簿 — 如果找不到条目，它就无法建立连接。

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

* **域名拼写错误** — URL可能有拼写错误
* **DNS服务器问题** — 您的DNS服务器未响应
* **域名过期** — 域名注册可能已失效
* **DNS传播** — 最近的DNS更改尚未传播
* **本地DNS缓存** — 您设备上缓存的DNS信息已过时

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

### 1. 核对域名[​](#1-verify-the-domain-name "直接链接到 1. 核对域名")

仔细检查URL是否有拼写错误。尝试在浏览器中访问该网站。

### 2. 检查域名状态[​](#2-check-domain-status "直接链接到 2. 检查域名状态")

使用WHOIS查询进行验证：

* 确认域名仍然注册
* 没有过期
* DNS记录已配置

### 3. 清除DNS缓存[​](#3-clear-dns-cache "直接链接到 3. 清除DNS缓存")

**在您的设备上：**

macOS：

```
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
```

Windows：

```
ipconfig /flushdns
```

### 4. 尝试备用DNS[​](#4-try-alternative-dns "直接链接到 4. 尝试备用DNS")

切换到公共DNS服务器，例如：

* Google: `8.8.8.8` 和 `8.8.4.4`
* Cloudflare: `1.1.1.1`

### 5. 等待DNS传播[​](#5-wait-for-dns-propagation "直接链接到 5. 等待DNS传播")

如果您最近更改了DNS设置，请等待24-48小时以便完全传播。

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

* [API01006](/zh-CN/error-codes/API01006.md) — 网络无法访问
* [API06001](/zh-CN/error-codes/API06001.md) — 无效的URL格式