Проверьте, какую операцию выполняет сборщик: добавляет страницы приложения или накладывает содержимое одной страницы на существующий лист. Второй вариант подходит для фона или штампа, но не добавит остальные листы автоматически. Возьмите искусственное приложение с тремя разными маркерами и проследите каждый до итогового PDF.
Склейка страниц отличается от наложения
Документация pypdf рекомендует append или merge для добавления страниц; merge позволяет указать позицию вставки. В том же руководстве merge_page используется для объединения содержимого страниц. Проверено 25 октября 2026 года. Название «merge» в вашем адаптере недостаточно: посмотрите реальный вызов библиотеки и переданный объект.
# Условный пример для pypdf на искусственных файлах
from pypdf import PdfWriter
writer = PdfWriter()
writer.append('main.pdf')
writer.append('annex.pdf')
writer.write('combined-new.pdf')
# Полнота, порядок и вид страниц проверяются отдельно.Этот пример добавляет приложение целиком и не выполняет выдачу клиенту. Выходное имя должно быть новым для теста; не указывайте исходный файл как место записи результата. Перед использованием в продукте закрепите установленную версию библиотеки и проверьте её контракт, форматы входов и обработку ошибок.
Диапазон легко теряет последний лист
| Слой | Частая ошибка |
|---|---|
| Чтение входа | Взят только reader.pages[0] |
| Выбор страниц | Вместо всех передан один индекс |
| Диапазон | Конечная граница понята как включённая |
| Позиция вставки | Индекс и номер печатной страницы перепутаны |
| Сборка | Результат перезаписан следующей частью |
В примерах pypdf диапазон pages=(0, 3) означает первые три страницы. При собственном интерфейсе «с первой по третью» явно преобразуйте пользовательские номера в контракт библиотеки. Не храните число страниц только в подписи приложения: сверяйте фактически прочитанный документ.
Если приложение сначала конвертируется из DOCX или изображения, проверьте полноту ещё до добавления. Склейщик не вернёт листы, которые потерял конвертер. Разделите контрольные результаты: вход приложения, конвертированный PDF и общий документ. У каждого должны быть известны число страниц и контрольные маркеры.
Количество страниц подтверждает лишь часть результата
- Сверить сумму выбранных страниц с итоговым числом.
- Найти первый, средний и последний маркеры приложения.
- Проверить порядок и место вставки.
- Просмотреть повёрнутые листы и разные размеры страниц.
- Повторить сборку без удвоения уже вставленных листов.
Число страниц может совпасть даже при повторе первого листа вместо остальных. Поэтому нужен маркер каждого тестового листа и визуальный просмотр. Если документ содержит интерактивные формы, отдельно проверьте поля: руководство pypdf предупреждает о конфликте одинаковых имён форм при объединении. Обычный просмотр текста такой конфликт может не показать.
Сохраняйте самостоятельные исходники и утверждённый список приложений. Операция сборки должна создавать новый артефакт и иметь явный исход ошибки. Не выдавайте половину документа под финальным именем после исключения на середине процесса; решение о частичном результате требует отдельного правила продукта.
Для поиска сбоя нужны версия библиотеки, безопасный фрагмент вызова, ожидаемый диапазон и три искусственных листа. Исправление принято, когда каждый выбранный лист присутствует на своём месте, повтор не удваивает приложение, а сохранённые исходники позволяют пересобрать документ после отката.