tencent cloud

邮件推送

动态与公告
产品动态
关于新增独立 IP 增值服务的公告
产品简介
产品概述
产品功能
产品优势
应用场景
规格明细
购买指南
价格说明
快速入门
邮件配置
邮件发送
信誉度等级说明
控制台指南
邮件配置
邮件发送
数据统计
投递回应
API 文档
History
Introduction
API Category
调用方式
域名验证相关接口
邮件相关接口
模板相关接口
统计相关接口
发信地址相关接口
黑名单相关接口
查询发送状态相关接口
批量任务相关接口
自定义黑名单相关接口
Data Types
Error Codes
SMTP 文档
SMTP 发送邮件指南
SMTP 服务地址
Java 调用示例
Go 调用示例
PHP 调用示例
Python 调用示例
C# 调用示例
发送带附件的邮件
错误码
Webhook 文档
邮件通知事件
发件限制
附件类型
常见问题
入门相关问题
计费相关问题
发送限制相关问题
发送功能相关问题
域名相关问题
模板相关问题
身份验证和配置相关问题
独立 IP 相关问题
递送相关问题
API 使用相关问题
回调相关问题
垃圾箱相关问题
安全性相关问题
域名加速配置相关问题
注意事项
其他问题
联系我们

错误码

PDF
聚焦模式
字号
最后更新时间: 2026-03-09 16:35:25

输入参数

域名
含义
备注
Bcc
暗送地址
目前不支持。
Cc
抄送地址
目前不支持。
Content-Transfer-Encoding
内容的传输编码方式
目前没有用到,不用传,除了附件内容之外,其他的内容无需加密。
Content-Type
内容的类型
目前必须传 text/plain; charset=UTF-8,text/html; charset=UTF-8 multipart/mixed, multipart/related 和 multipart/alternative 中的一种,传其他的会报错。
Date
日期和时间
目前没有用到。
Delivered-To
发送地址
目前没有用到。
From
发件人地址
必传。
Message-ID
消息 ID
目前没有用到。
MIME-Version
MIME 版本
目前没有用到,不传或者传1.0。否则会报错。
Received
传输路径
目前没有用到。
Reply-To
回复地址
目前没有用到。
Return-Path
回复地址
目前没有用到。
Subject
主题
必传。
To
收件人地址
必传。

附件部分参数(发送附件时)

域名
含义
备注
Content-Type
段体的类型
文件建议传 application/octet-stream。
Content-Transfer-Encoding
段体的传输编码方式
目前仅支持传 base64,传其他的会报错。
Content-Disposition
段体的安排方式
目前仅支持传 attachment,传其他的会导致无法发送附件。
Content-ID
段体的 ID
目前不支持。
Content-Location
段体的位置(路径)
目前不支持。
Content-Base
段体的基位置
目前不支持。
说明:
输入参数校验要求总体与 发信接口 保持一致:包含收件人邮箱数量,邮件正文大小,附件格式,附件大小等限制。

返回参数

SMTP 接口无返回参数,仅支持返回 err 信息。若返回 nil,则标识调用接口成功,但实际发信不一定成功,获取邮件的发送状态可参见 获取邮件发送的状态

错误码

系统级错误

1. body 部分单行超过2000,或以上更多 554 5.0.0 Error: transaction failed, blame it on the weather: smtp: too longer line in input stream 或其他包含 too longer 的日志。 write tcp *.*.*.*:60575->*.*.*.*:25: write: broken pipe
2. 附件大小过大。
附件9M左右 返回 EOF,建议附件总大小低于8M,整体报文大小不能超过10M,否则内容会截断,会报 base64 解码失败等其他异常错误。

业务级错误

业务报错形式如下: 554 5.0.0 Error: transaction failed, blame it on the weather: ##SES-response-json: {"Response":{"RequestId":"bee4e9fb-8127-48cc-b606-bbb1e801596b","QcloudError":{"Error":{"Code":"FailedOperation.MissingEmailContent.操作失败。缺少发信内容(TemplateData和Simple不能同时为空)。
##SES-response-json: 之后的是发信接口返回的结构体的 json 形式,字段说明如下:
字段
字段类型
含义
RequestId
string
请求 ID。
QcloudError
stuct
错误结构体。
QcloudError:
字段
字段类型
含义
Code
string
错误码。
Message
string
错误信息。
一般业务错误说明:
错误码
错误描述
备注
FailedOperation
msg.From is null
发信人为空。
FailedOperation
msg.Subject is null
发信主题为空。
FailedOperation
msg.Body is null
发信内容为空。
FailedOperation
Content-Transfer-Encoding must in...
检查附件的 Content-Transfer-Encoding,参照入参说明。
FailedOperation
Content-Type must in...
检查 Header 中的 Content-Type,参照入参说明。
FailedOperation
Mime-Version must in...
检查 Header 中的 Mime-Version,参照入参说明。
FailedOperation
The email is too large. Remove some content...
除了附件之外的邮件正文不能超过1M。
FailedOperation
Incorrect attachment content. Make sure the base64 content is...
附件的内容需要 base64 加密。
FailedOperation
The attachments are too large. Make sure they do not exceed the...
单个附件超过5M。或所有附件大小超过10M(具体大小可能会调整)。
RequestLimitExceeded.SmtpRateLimit
smtp sending frequency limit...
触发 SMTP 调用频率限制。
FailedOperation
Incorrect body content. Make sure the base64 content is correct.
邮件正文部分指定了 base64 编码但没有用 base64 加密。
FailedOperation
SMTPForbidden
个人客户禁用 SMTP。

其他业务报错

您可参见 发送邮件 中的错误码描述。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈