Если письмо без файла уходит, а с файлом падает или приходит пустым, 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 разрешайте только для временных ошибок, а неверное поле или превышение лимита отправляйте на исправление.
Контрольный прогон включает плохие файлы
- Отправить маленький PDF и сверить checksum до узла и в сохранённой MIME-части.
- Переименовать binary property и убедиться, что проверка останавливает workflow до отправки.
- Передать файл нулевого размера и получить понятную постоянную ошибку.
- Проверить два вложения с разными MIME и именами.
- Сымитировать timeout после приёма письма и не отправить дубликат.
- Удалить тестовые файлы по политике хранения и подтвердить отсутствие публичных ссылок.
Для разбора подготовьте экспорт workflow без credentials, названия входных binary properties, размеры, MIME, безопасные execution IDs и ответ почтового узла. Реальные документы и адреса замените синтетическим файлом: для поиска разрыва нужны метаданные, а не содержимое.