149b201300
- 修复邮件服务区域配置（改为ap-hongkong） - 增强支付宝支付错误诊断和日志 - 修复代码质量问题（OrderService、ImageToVideoTask） - 添加支付宝支付问题排查文档 - 增加详细的错误诊断信息
113 lines
3.6 KiB
Markdown
113 lines
3.6 KiB
Markdown
# 腾讯云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. **联系腾讯云客服**：通过控制台联系客服获取帮助
|
||
|
||
## 临时解决方案
|
||
|
||
如果需要快速测试，可以临时使用开发模式：
|
||
|
||
```properties
|
||
# 在 application-dev.properties 中
|
||
tencent.ses.template-id=0
|
||
```
|
||
|
||
开发模式下不会发送真实邮件，验证码会记录在日志中。
|
||
|