Если письмо без файла уходит, а с файлом падает или приходит пустым, SMTP обычно находится в конце цепочки и не является первой точкой проверки. Возьмите один маленький тестовый документ без персональных данных и проследите, где workflow перестаёт видеть его как binary-объект.

В n8n почтовый узел ждёт имя binary property из входного элемента. Строка с путём, URL или base64 в обычном JSON-поле не становится вложением автоматически. Сначала подтвердите байты и метаданные на входе узла, потом разбирайте ответ почтового провайдера.

Сбой начинается там, где binary превращается в JSON

НаблюдениеВероятная потеряСледующая проверка
Поля attachment нетПредыдущий узел вернул только JSONСравнить input и output этого узла
Размер стал нулевымПоток прочитан или файл удалён раньше времениПроверить lifecycle временного файла
Файл есть под другим именемПочтовый узел смотрит не в то propertyСверить Attachment Field Name
Маленький файл проходит, большой нетЛимит памяти, API или reverse proxyСнять размер и точный HTTP-статус
Письмо принято без вложенияНе собрана MIME-частьПосмотреть raw message тестового письма

Вложение получает технический паспорт

attachment = {
  property: "invoice",
  fileName: "test-invoice.pdf",
  mimeType: "application/pdf",
  size: 18432,
  sha256: "test-checksum-only"
}
assert(binary[attachment.property].size == attachment.size)

Паспорт хранит только технические признаки. Содержимое файла, base64 и адрес получателя в журнал не попадают. Checksum позволяет понять, что до отправки дошли те же байты, а не другой файл с совпадающим именем.

Имя поля проверяется на каждом узле

После merge, code или AI-узла сравните список binary properties до и после. Некоторые операции создают новый item только из JSON и тем самым теряют бинарную часть. Явно перенесите ссылку на binary либо перестройте workflow так, чтобы текстовая обработка не пересобирала объект с файлом.

Для нескольких вложений задайте стабильные имена, например invoice и terms, и перечислите их в настройке отправки. Не вычисляйте имя из пользовательского filename: filename предназначен получателю, а внутренний property — контракт между шагами.

Большой файл не путешествует по всем шагам

  • Сохранить объект во временное или внешнее хранилище с закрытым доступом.
  • Передавать между шагами object key и проверяемые метаданные.
  • Получать файл непосредственно перед отправкой письма.
  • Ограничить размер и разрешённые MIME до тяжёлой обработки.
  • Удалять временный объект только после подтверждённого результата и периода безопасного повтора.

Такой маршрут уменьшает память execution и не заставляет сериализовать большие base64-строки. Доступ к объекту должен быть серверным и ограниченным; публичная бессрочная ссылка в письме или execution log создаёт отдельную утечку.

Повтор не создаёт второе письмо

Таймаут после запроса не доказывает, что письмо не принято. Сохраните send key из business event, шаблона и checksum набора вложений. Перед повтором ищите уже созданную попытку и её provider message ID. Автоматический retry разрешайте только для временных ошибок, а неверное поле или превышение лимита отправляйте на исправление.

Контрольный прогон включает плохие файлы

  1. Отправить маленький PDF и сверить checksum до узла и в сохранённой MIME-части.
  2. Переименовать binary property и убедиться, что проверка останавливает workflow до отправки.
  3. Передать файл нулевого размера и получить понятную постоянную ошибку.
  4. Проверить два вложения с разными MIME и именами.
  5. Сымитировать timeout после приёма письма и не отправить дубликат.
  6. Удалить тестовые файлы по политике хранения и подтвердить отсутствие публичных ссылок.

Для разбора подготовьте экспорт workflow без credentials, названия входных binary properties, размеры, MIME, безопасные execution IDs и ответ почтового узла. Реальные документы и адреса замените синтетическим файлом: для поиска разрыва нужны метаданные, а не содержимое.

Проверенные источники