Проверьте, какую операцию выполняет сборщик: добавляет страницы приложения или накладывает содержимое одной страницы на существующий лист. Второй вариант подходит для фона или штампа, но не добавит остальные листы автоматически. Возьмите искусственное приложение с тремя разными маркерами и проследите каждый до итогового 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 и общий документ. У каждого должны быть известны число страниц и контрольные маркеры.

Количество страниц подтверждает лишь часть результата

  1. Сверить сумму выбранных страниц с итоговым числом.
  2. Найти первый, средний и последний маркеры приложения.
  3. Проверить порядок и место вставки.
  4. Просмотреть повёрнутые листы и разные размеры страниц.
  5. Повторить сборку без удвоения уже вставленных листов.

Число страниц может совпасть даже при повторе первого листа вместо остальных. Поэтому нужен маркер каждого тестового листа и визуальный просмотр. Если документ содержит интерактивные формы, отдельно проверьте поля: руководство pypdf предупреждает о конфликте одинаковых имён форм при объединении. Обычный просмотр текста такой конфликт может не показать.

Сохраняйте самостоятельные исходники и утверждённый список приложений. Операция сборки должна создавать новый артефакт и иметь явный исход ошибки. Не выдавайте половину документа под финальным именем после исключения на середине процесса; решение о частичном результате требует отдельного правила продукта.

Для поиска сбоя нужны версия библиотеки, безопасный фрагмент вызова, ожидаемый диапазон и три искусственных листа. Исправление принято, когда каждый выбранный лист присутствует на своём месте, повтор не удваивает приложение, а сохранённые исходники позволяют пересобрать документ после отката.

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