[Bug]: Unable to Configure AWS SES SMTP Credential When Using Email Component in Agent Editor

快速结论：该报错出现在 RAGFlow Agent 编辑器的 Email 组件中，当使用 AWS SES 作为 SMTP 服务时，由于组件将“发件人邮箱地址”直接作为 SMTP 登录用户名进行认证，而 AWS SES 要求使用独立的 SMTP 用户名（如 AKIA...），导致认证失败。解决该问题的 PR (#13195) 已合并，建议更新代码以支持独立的 SMTP 用户名配置。

问题场景

用户在 RAGFlow v0.24.x 中，通过 Docker Compose 部署后，在 Agent 编辑器中添加 Email 组件，并配置 AWS SES（区域 eu-west-1）的 SMTP 服务，端口 587（STARTTLS）。执行 Agent 时触发 SMTP 认证失败。

报错原文

Connecting to SMTP server email-smtp.eu-west-1.amazonaws.com:587
Attempting to login with email: no-reply@domain.com
SMTP Authentication failed.

原因分析

Email 组件在认证时，直接将“发件人邮箱地址”（如 no-reply@domain.com）作为 SMTP 登录用户名，但 AWS SES 要求使用专门的 SMTP 用户名（如 AKIA...）进行认证。由于组件没有提供独立的“SMTP 用户名”输入框，导致用户名不匹配，认证失败。

注意：此问题可能不仅影响 AWS SES，任何 SMTP 登录用户名与发件人邮箱不相同的服务商都可能受到影响。

环境排查

确认 RAGFlow 版本是否为 v0.24.x（Issue 中使用的版本）
确认部署方式（Issue 中为 Docker Compose）
确认 AWS SES 区域（如 eu-west-1）和 SMTP 端点（如 email-smtp.eu-west-1.amazonaws.com）
确认使用的端口：587（STARTTLS）
确认 SMTP 用户名（SES SMTP username，格式如 AKIA...）和密码已正确从 AWS 控制台获取

解决步骤

应用修复 PR (#13195)：
- 获取修复分支代码：git fetch upstream pull/13195/head
- 切换到该分支：git checkout FETCH_HEAD
- 按正常方式启动 RAGFlow
该 PR 已由 RAGFlow 维护者确认并合并到主线中。如果使用主线代码，直接拉取最新代码即可。
重新配置 Email 组件：
- 在 Agent 编辑器中重新添加或编辑 Email 组件
- 在 SMTP 用户名（SMTP username）字段中填入 AWS SES 提供的 SMTP 用户名（如 AKIA...）
- 在 SMTP 密码字段中填入对应的 SES SMTP 密码
- 确保“发件人邮箱”（Sender email）字段仍填入正确的邮箱地址（如 no-reply@domain.com）

验证方法

在 Agent 编辑器中执行一个使用该 Email 组件的工作流，检查日志中是否出现 SMTP Authentication successful 或类似成功消息，并确认邮件已成功发送到目标邮箱。

参考来源

infiniflow/ragflow #13179

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。

[Bug]: Unable to Configure AWS SES SMTP Credential When Using Email Component in Agent Editor