快速结论:该问题通常发生在自托管 n8n 使用 Email Trigger (IMAP) 接收带附件邮件、且二进制存储为 PostgreSQL(binary_data 表)的场景。优先排查 binary_data 表中 sourceType = execution、sourceId = temp 的记录是否在邮件和附件处理完成、甚至删除执行历史后仍持续累积。
适用环境:n8n 2.34.5(self-hosted、Docker 部署);操作系统 Ubuntu 24.04.4 LTS;Node.js 24.18.0;数据库 PostgreSQL 16;二进制存储为 PostgreSQL(binary_data);Execution mode 为 queue;触发节点为 Email Trigger (IMAP)。Issue 中未提供更多依赖信息。
最快修复方案:暂无确认的一步修复方案。该 Issue 已被标记为已解决,官方表示修复会包含在后续版本中,因此可优先尝试升级到包含该修复的 n8n 版本(具体版本号 Issue 未注明)。
注意事项:Issue 中未给出修复对应的具体版本号、补丁内容或使用脚本手动清理 temp 数据的官方步骤;在升级前,累积的 binary_data 记录可能仍需人工评估是否清理,清理前请务必确认这些记录不再被任何执行使用。
问题场景
在自托管 n8n 中创建带 Email Trigger (IMAP) 节点的工作流,接收带二进制附件的邮件,并将附件传递到其他工作流继续处理。工作流执行成功、附件也已处理完毕,但对应的二进制数据没有被移除,而是以 sourceType = execution、sourceId = temp 的形式残留在 PostgreSQL 的 binary_data 表中,随时间逐步累积(Issue 中约 172 MB、228 个文件,主要为 xls 等附件)。即使用户通过 n8n UI 删除执行历史,这些 sourceId = temp 的记录仍然存在,且 execution_entity 中已无对应执行 ID。
报错原文
Email Trigger (IMAP) leaves processed email attachments in binary_data
原因分析
根据 Issue 描述,问题现象是已处理的邮件附件对应的二进制数据未被清理,并以 sourceType = execution、sourceId = temp 写入 binary_data 表。由于这些记录的 sourceId 为 temp 而非具体执行 ID,它们不随执行历史删除而级联清理,可能因此绕过了基于执行记录的保留/清理逻辑。Issue 正文明确表示:“The reason why temp data is not being cleaned up has not yet been determined.” 因此具体根因在 Issue 中未被确认,上述机制属于基于现象的可能原因。官方评论仅确认问题已解决、修复将随后续版本发布,未披露修复细节。
环境排查
- 确认 n8n 版本是否为 2.34.5 或受影响的相近版本,并检查是否已升级到包含修复的版本。
- 确认部署方式与执行模式(self-hosted、Docker、queue 模式)。
- 确认二进制存储配置为 PostgreSQL(binary_data 表),而非文件系统或其他存储后端。
- 确认数据库为 PostgreSQL 16,并检查 binary_data 表中 sourceType = execution、sourceId = temp 的记录数量与体积。
- 确认相关执行的 execution_entity 记录是否已删除,以及 binary_data 中是否仍有残留记录。
- 确认工作流中 Email Trigger (IMAP) 节点接收的附件是否被传递到其他工作流处理,以复现数据流转场景。
解决步骤
- 先按 Issue 中的 SQL 统计 binary_data 表内不同 sourceType、sourceId 的文件数与体积,确认是否存在 sourceType = execution、sourceId = temp 的累积记录:
SELECT "sourceType", "sourceId", COUNT(*) AS files, SUM("fileSize") AS bytes, pg_size_pretty(SUM("fileSize")::bigint) AS total_size FROM binary_data GROUP BY "sourceType", "sourceId" ORDER BY bytes DESC; - 对比 execution_entity 表,确认这些 temp 记录是否已无对应执行 ID,以判断是否为 Issue 描述的残留数据。
- 由于 Issue 已标记为已解决且修复将包含在后续版本中,优先将 n8n 升级到包含该修复的版本(版本号未在 Issue 中注明,升级前请查阅对应版本的发布说明)。
- 升级后重新运行带附件邮件的 IMAP 触发工作流,并按上述 SQL 再次统计,观察是否仍有新的 sourceId = temp 记录产生。
- 对于升级前已累积的历史 temp 记录,Issue 未提供官方清理步骤;如需清理,应在确认这些记录不属于任何待用执行后再处理,并建议先做数据库备份。
验证方法
升级并重新处理带附件邮件、删除对应执行历史后,再次执行 Issue 中的统计 SQL:若 binary_data 中不再出现持续新增的 sourceType = execution、sourceId = temp 记录,且已处理的附件数据随执行清理被移除,即可认为问题已解决。若升级后仍持续累积,可按官方评论所述在该 Issue 下留言反馈。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


