Files
AIGC/demo/SES_TROUBLESHOOTING_GUIDE.md
AIGC Developer 149b201300 优化邮件发送功能和支付宝支付诊断
- 修复邮件服务区域配置(改为ap-hongkong)
- 增强支付宝支付错误诊断和日志
- 修复代码质量问题(OrderService、ImageToVideoTask)
- 添加支付宝支付问题排查文档
- 增加详细的错误诊断信息
2025-11-03 13:20:30 +08:00

3.6 KiB
Raw Blame History

腾讯云SES邮件发送问题排查指南

当前错误

错误码: FailedOperation.SendEmailErr
错误信息: 操作失败。您的发送遇到问题请检查Region参数是否指定准确若Region参数无误请联系腾讯云提交工单沟通原因并解决。

问题诊断

这个错误通常表示以下问题之一:

1. 发信地址未验证 ⚠️ 最常见

  • 发信地址 newletter@vionow.com 可能未在腾讯云SES控制台的 广州区域 验证
  • 需要在对应区域验证发信地址或域名

2. 模板ID不存在或区域不匹配

  • 模板ID 154360 可能不存在于广州区域
  • 模板可能在其他区域创建,需要确认模板所在区域

3. 区域配置不匹配

  • 当前配置区域:ap-guangzhou(广州)
  • 需要确保腾讯云控制台选择的地域与代码配置一致

解决步骤

步骤1: 登录腾讯云SES控制台

访问:https://console.cloud.tencent.com/ses

步骤2: 确认选择的地域

  1. 在控制台右上角,确认当前选择的地域是否为 "广州"ap-guangzhou
  2. 如果选择了其他地域,切换到广州区域

步骤3: 验证发信地址

  1. 进入 "发信地址""身份验证" 页面
  2. 检查 newletter@vionow.com 是否已添加并验证通过
  3. 如果未添加:
    • 点击 "添加发信地址"
    • 输入 newletter@vionow.com
    • 完成验证(通常会收到验证邮件)
    • 等待审核通过(通常几分钟到几小时)

步骤4: 检查模板ID

  1. 进入 "邮件模板" 页面
  2. 确认模板ID 154360 是否存在
  3. 确认模板状态为 "已审核""已通过"
  4. 如果模板不存在:
    • 检查模板是否在其他区域创建
    • 或者在当前区域重新创建模板
    • 获取新的模板ID并更新配置

步骤5: 检查账户状态

  1. 确认SES服务已开通
  2. 检查账户是否有发送配额
  3. 检查是否有账户限制或黑名单

当前配置信息

根据您的配置文件:

  • SecretID: AKIDoaEjFbqxxqZAcv8EE6oZCg2IQPG1fCxm
  • 区域: ap-guangzhou(广州)
  • 发信地址: newletter@vionow.com ⚠️ 需要验证
  • 模板ID: 154360 ⚠️ 需要确认存在

快速检查清单

  • 在腾讯云SES控制台选择的地域是否为"广州"
  • 发信地址 newletter@vionow.com 是否已在广州区域验证通过?
  • 模板ID 154360 是否存在于广州区域?
  • 模板状态是否为"已审核"
  • 账户是否有发送配额?
  • 访问密钥是否具有SES发送邮件权限

常见问题

Q: 发信地址验证需要多长时间?

A: 通常几分钟到几小时,验证邮件会发送到邮箱地址的邮箱管理员处。

Q: 如何验证域名而不是单个邮箱?

A: 可以添加域名 vionow.com 进行验证,验证后该域名下所有邮箱都可以发信。

Q: 模板在不同区域可以通用吗?

A: 不可以,模板是区域隔离的,需要在使用的区域创建模板。

Q: 如何查看模板的详细信息?

A: 在SES控制台的"邮件模板"页面点击模板ID查看详情确认模板内容和状态。

如果仍然失败

如果完成以上步骤后仍然失败,请:

  1. 检查腾讯云工单:提交工单获取技术支持
  2. 查看详细日志:检查应用日志中的完整错误堆栈
  3. 联系腾讯云客服:通过控制台联系客服获取帮助

临时解决方案

如果需要快速测试,可以临时使用开发模式:

# 在 application-dev.properties 中
tencent.ses.template-id=0

开发模式下不会发送真实邮件,验证码会记录在日志中。