n8n Email节点报错？别慌，这5个坑我都踩过
作为 N8N大学 的首席主编，我必须承认：在 n8n 的无数个深夜里，最让我抓狂的往往不是复杂的逻辑拼接，而是看似简单的 Email 节点。
你是否也遇到过这样的场景：流程跑得好好的，一到发邮件环节就红灯报警？看着满屏的 554 5.7.1 或 421 4.7.0，那种无力感简直让人想砸键盘。别急，笔者这就带你复盘这 5 个最常见的“天坑”，全是血泪经验。
坑一：Gmail 的“不安全应用”幽灵
这是新手最容易中招的陷阱。很多教程只教你怎么开启两步验证，却没告诉你 Google 的“不安全应用”限制有多狡猾。
问题复现：当你使用 Gmail SMTP 配置 Email 节点时，报错提示通常是 535 Authentication failed。
深度解析：这不是你的密码错了，也不是 n8n 的锅。Google 默认禁止第三方应用通过简单密码登录。即便你开启了两步验证，直接填入 Gmail 账号密码依然会被拦截。
解决方案：
- 前往 Google 账户设置，找到“安全性”选项卡。
- 开启“两步验证”（这是前提）。
- 在“安全”页面的搜索栏中，搜索并进入“应用密码”创建页面。
- 生成一个 16 位的随机密码，将其复制到 n8n Email 节点的密码字段中，覆盖你的原始密码。
坑二：SMTP 服务端口与加密的“错配”
很多同学在配置企业邮箱或自建 SMTP 时，习惯性地把所有设置都填满，结果反而导致握手失败。
避坑指南：SMTP 协议中，端口（Port）和安全协议（Security Protocol）必须成对出现，不能乱点鸳鸯谱。
笔者整理了最常用的三种配置组合，请直接对照你的 SMTP 服务商说明填写：
| 安全协议 | 推荐端口 | 适用场景 |
|---|---|---|
| None (无) | 25 | 局域网内或不加密的旧式服务器（公网通常被拦截） |
| STARTTLS | 587 / 2525 | 最常用（如 Gmail, Outlook, Mailgun） |
| SSL/TLS | 465 | 传统加密端口，部分云服务商强制使用 |
切记：如果你选了端口 465，Security Protocol 必须选 SSL/TLS；如果选了 587，通常选 STARTTLS。选错一个，连接直接超时。
坑三：HTML 内容中的“隐形杀手”
有时候配置都没问题，但邮件就是发不出去，或者发出去了进垃圾箱。问题往往出在 Email 节点的 HTML 字段里。
原因分析：n8n 的 Email 节点基于 Nodemailer，它对 HTML 代码的容错率很低。如果你直接从网页复制富文本，里面会携带大量不可见的样式标签（如 style="font-family: 'xxx';"）或空属性。
实战技巧：
- 净化代码：在将 HTML 传入 n8n 之前，先用在线工具（如 HTML Cleaner）清洗一遍。
- 避免内联样式过多：尽量使用简单的
<div>和<span>标签。 - 转义字符：如果 HTML 中包含特殊字符（如
©），确保你的 JSON 输入是合法的，否则会导致 JSON 解析错误，进而让整个节点崩溃。
坑四：附件发送失败与 Base64 陷阱
当你需要通过 Email 节点发送附件（比如生成的 PDF 或截图）时，这是最容易导致流程中断的地方。
问题复现：报错提示 Error: No attachments found 或者 Invalid multipart body。
深度解析：n8n 的 Email 节点对附件数据的格式要求极其严格。它要求附件是一个包含 filename、contentType 和 content 的对象。
如果你是通过 HTTP Request 下载文件后直接传给 Email 节点，必须注意：
- 数据格式转换：下载的二进制数据（Binary Data）通常需要转换为 Base64 字符串。
- 字段映射：在 Email 节点的 "Attachments" 参数中，确保 JSON 表达式正确。例如：
{{ $json.data }}（假设你的二进制数据在 data 字段中）。 - 文件名：如果 JSON 中没有显式指定
filename属性，邮件客户端可能无法识别附件。
坑五：n8n 主机 IP 被列入黑名单
这是最令人头疼的“玄学”问题。如果你使用的是自建 n8n（比如在 AWS、阿里云、腾讯云的 VPS 上），且使用默认的 25 端口发送邮件，极大概率会被拒收。
原因分析：云服务提供商（CSP）为了防止垃圾邮件，通常会默认封禁出站的 25 端口。即便你配置无误，收件方服务器（如 Gmail、QQ 邮箱）也会检测发送源 IP。如果发现你的 IP 来自数据中心且未做反向解析（Reverse DNS），直接拒收或标记为垃圾邮件。
解决方案：
- 使用第三方 SMTP 服务：这是最稳妥的方案。推荐使用 Amazon SES、Mailgun 或 SendGrid。它们有完善的 IP 信誉体系，并且 n8n 官方对这些服务商有很好的兼容性。
- 修改端口：尝试使用 587 或 465 端口（需确认服务器未封禁）。
- 申请解封：向云服务商申请解封 25 端口（流程繁琐，且成功率不高）。
FAQ：你可能还想问
1. 为什么我的测试连接显示成功，但实际发送失败？
测试连接通常只验证账号密码和端口的连通性（SMTP 握手），不包含完整的邮件内容发送流程。如果报错发生在发送阶段（如附件过大、内容格式错误），测试连接是不会报错的。
2. 我可以用 n8n Email 节点群发邮件吗？
技术上可以，但**强烈不建议**。直接使用单个邮箱账号群发极易触发反垃圾邮件机制，导致封号。如果需要群发，请务必使用专业的邮件营销平台（ESP）并通过 API 接入。
3. 如何调试 Email 节点的具体错误？
在 n8n 中，点击运行记录，查看 Email 节点的输出详情。如果信息不够，可以在 Email 节点后连接一个 Function 节点，代码写入 return items;，并在运行历史中查看详细的 Error Stack Trace。
总结与资源
踩坑是学习 n8n 自动化的必经之路。Email 节点看似简单，实则涉及 SMTP 协议、网络防火墙、数据格式化等多个维度。
记住 N8N大学 的核心原则：先验证配置，再优化内容；先用第三方 SMTP，再考虑自建。
如果你在配置过程中遇到了更诡异的报错，欢迎在 N8N大学 社区留言，我们一起拆解。下期我们将探讨如何将 Email 节点与 AI 节点结合，实现智能邮件自动回复。
