> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 邮件故障排除

> 如何诊断和解决常见的 OneSignal 邮件问题。

使用本指南识别和解决最常见的 OneSignal 邮件问题，包括设置问题、送达性挑战和设计错误。

<Note>
  在故障排除之前，请查看我们的[邮件设置](./email-setup)和[邮件送达性](./email-deliverability)指南。这些涵盖了邮件问题的最常见原因。
</Note>

## 设置问题

大多数设置问题来自错误的 DNS 记录或邮件服务提供商 (ESP) 的限制。

### 验证 DNS 记录

1. 打开您的 DNS 提供商。
2. 确认 SPF、DKIM 和 MX 记录与我们的[邮件 DNS 配置](./email-dns-configuration)指南匹配。
3. 允许 DNS 更改最多 24 小时来传播。

<Warning>
  如果 DNS 记录配置错误，邮件可能无法发送、退回或被标记为垃圾邮件。
</Warning>

### 月度发送限制（非 OneSignal ESP）

如果您直接使用 SendGrid、Mailchimp 或 Mailgun（不通过 OneSignal 邮件），您的发送量受限于您的 ESP 计划。\
检查您提供商的日志：

* [SendGrid 活动订阅源](https://www.twilio.com/docs/sendgrid/ui/analytics-and-reporting/email-activity-feed)
* [Mailchimp 活动与报告](https://mailchimp.com/developer/transactional/docs/activity-reports/)
* [Mailgun 日志](https://www.mailgun.com/products/send/email-analytics/logs/)

### DNS 查找过多

当使用 [URI 测试](https://www.uriports.com/tools?method=spf\&domain=mail.daystrom-institute.com) 等工具测试 SPF 记录时，您可能会看到：

<Frame caption="DNS 查找过多">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/email/email-troubleshooting-too-many-dns-lookups.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=926c451d7d99431a4ed0e8092ff6b014" alt="DNS 查找过多" width="1127" height="338" data-path="images/email/email-troubleshooting-too-many-dns-lookups.png" />
</Frame>

如果您使用以下 SPF 记录，这是预期的：

```
v=spf1 include:spf.onesignal.email include:mailgun.org ~all
```

OneSignal 在"幕后"使用 Mailgun 作为我们的邮件服务提供商。这意味着 SPF 查找指向相同的 IP 范围，实际上并不添加任何额外的查找。要移除警告，您可以简化为：

```
v=spf1 include:mailgun.org ~all
```

这将防止错误，不会影响 OneSignal 邮件发送。

### 发送域名的多个 TXT 记录

您的发送域名只能有**一个** SPF 记录。\
使用 [WhatsMyDNS TXT 查找](https://www.whatsmydns.net/#TXT) 检查以确认您没有多个条目。

***

## 送达性问题

送达性问题包括发送缓慢、进入垃圾邮件文件夹和邮件退回。

### 延迟邮件

如果您的发送域名是新的或声誉较低，ISP（Gmail、Outlook、Yahoo）可能会延迟投递。这被称为**速率限制**或**灰名单**。查看您的[邮件消息报告](./email-message-reports)时，您可以检查我们发送消息所花费的时间详情。

<Frame caption="从 OneSignal 发送邮件不到 3 秒">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/email/email-speed-message-report.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=ac366a1120913e1ee2204e7ce2baa4ed" alt="邮件消息报告" width="2186" height="816" data-path="images/email/email-speed-message-report.png" />
</Frame>

在此示例中，我们看到邮件从 OneSignal 发送用时不到 3 秒。我们将其发送到邮件服务提供商，然后再发送到收件人的 ISP。这些邮件服务器可能会将邮件延迟数小时后才投递给收件人。

<Note>
  遵循我们的[邮件声誉最佳实践](./email-reputation-best-practices)来加快投递速度。
</Note>

### 邮件进入垃圾邮件

最常见的原因是发送者声誉不良。请遵循我们的[邮件送达性](./email-deliverability)指南。

如果您使用第三方 ESP，请参阅：

* [SendGrid：拒绝列表](https://docs.sendgrid.com/ui/sending-email/deny-lists)
* [Mailgun：黑名单信息](https://help.mailgun.com/hc/en-us/articles/115005365027-What-Is-a-Blacklist-)
* [Mailchimp：声誉与拒绝](https://mailchimp.com/developer/transactional/docs/reputation-rejections/#rejected-emails)

### 从同一域名发送和接收

单个域名不能同时使用相同的 MX 记录进行发送和接收邮件。如果您想从 `@yourdomain.com` **发送**邮件，同时在同一域名上**接收**邮件：

* 在 OneSignal 保持您的发送 DNS。
* 将您的 MX 记录指向您的入站邮件提供商（例如，[Google Workspace MX 记录](https://support.google.com/a/topic/2683820?hl=en\&ref_topic=9202)）。

### 抑制列表

如果某个地址取消订阅或将您标记为垃圾邮件，您的 ESP 将抑制向其发送。\
重新订阅的步骤：

1. 在 OneSignal 中转到**受众 > 订阅**。
2. 搜索邮件地址。
3. 点击**取消订阅邮件**（如果已订阅），然后点击**重新订阅邮件**。
4. 发送测试邮件以确认。

### Apple Private Relay

如果您发送到 `@privaterelay.appleid.com` 地址，您必须在您的 [Apple Developer 账户](https://developer.apple.com/help/account/configure-app-capabilities/configure-private-email-relay-service/)中验证您的发送域名。\
未验证的域名将导致邮件被丢弃。

### API 密钥过于限制

如果使用 SendGrid 或 Mailchimp，确保您的 API 密钥具有[最低要求的权限](./sendgrid-setup#what-are-the-minimum-api-restrictions-i-can-allow)。

***

## 邮件设计

这些是邮件内容本身的问题。

### 链接不工作

通常由缺失或错误的 CNAME 配置引起。\
如果使用第三方 ESP，请遵循他们的跟踪域名设置。

### 按钮不可点击

* 确保 URL 正确并以 `https://` 开头。
* 避免从垃圾邮件文件夹测试——某些邮件客户端会阻止那里的链接。

### 向预览头添加图片

Gmail 支持在预览头中添加促销图片（交易注释、产品轮播）。\
请参阅 [Gmail 开发者门户](https://developers.google.com/gmail/promotab/overview)了解设置。

***

## 邮件服务提供商 (ESP)

与我们与 SendGrid、Mailchimp 或 Mailgun 的集成相关的常见问题或问题。

### 我必须为邮件付费给另一个提供商吗？

如果您使用 [OneSignal 邮件设置](./email-setup)，我们将管理您的邮件账户，您不需要使用其他邮件提供商。如果您计划使用 SendGrid、Mailchimp 或 Mailgun，则需要继续直接向您的邮件服务提供商付费。

## OneSignal 的邮件吞吐量是多少？

OneSignal 通常以每秒 1,000 到 5,000 封的速度向邮件服务提供商发送消息。由您的 ESP 负责将邮件投递给您的用户。

OneSignal 为 OneSignal 邮件使用 Mailgun，Mailgun 宣传他们可以支持高达[每小时 1500 万封邮件](https://www.mailgun.com/blog/product/how-quickly-can-mailgun-process-my-messages-introducing-the-rapid-fire-throughput-sla/)。