From 638e28c653b863055852c3588d148617b3d3c4bc Mon Sep 17 00:00:00 2001 From: Pjandro Date: Sun, 8 Nov 2026 16:41:06 +0000 Subject: [PATCH] =?UTF-8?q?fix(app):=20=D0=BF=D0=BE=D0=BB=D0=BD=D1=8B?= =?UTF-8?q?=D0=B9=20validate=20=D0=B2=D0=BD=D1=83=D1=82=D1=80=D0=B8=20?= =?UTF-8?q?=D0=B2=D0=BE=D1=80=D0=BA=D0=B5=D1=80=D0=B0=20(=D0=B4=D0=BE=20?= =?UTF-8?q?=D0=BE=D1=87=D0=B5=D1=80=D0=B5=D0=B4=D0=B8=20=E2=80=94=20=D1=82?= =?UTF-8?q?=D0=BE=D0=BB=D1=8C=D0=BA=D0=BE=20=D1=80=D0=B0=D0=B7=D0=BC=D0=B5?= =?UTF-8?q?=D1=80);=20500=20=D0=B1=D0=B5=D0=B7=20=D0=B4=D0=B5=D1=82=D0=B0?= =?UTF-8?q?=D0=BB=D0=B5=D0=B9=20=D1=8F=D0=B4=D1=80=D0=B0=20=D0=B2=20=D1=82?= =?UTF-8?q?=D0=B5=D0=BB=D0=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../wordpdf/app/ApiExceptionHandler.java | 10 ++++-- .../wordpdf/app/ConversionService.java | 31 ++++++++++--------- .../wordpdf/app/ConvertControllerTest.java | 10 ++++-- 3 files changed, 32 insertions(+), 19 deletions(-) diff --git a/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ApiExceptionHandler.java b/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ApiExceptionHandler.java index 2e9f082..6596f90 100644 --- a/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ApiExceptionHandler.java +++ b/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ApiExceptionHandler.java @@ -63,11 +63,17 @@ final class ApiExceptionHandler { .body(new ApiError(e.getMessage())); } - /** Ошибка ядра/рендера при формально корректном входе. */ + /** + * Ошибка ядра/рендера при формально корректном входе. Сообщение ядра + * (тексты docx4j/FOP/JAXB, пути temp-файлов) — только в лог: наружу + * фиксированный текст, иначе 500 становится каналом внутренней информации. + * Регрессия — ConvertControllerTest#conversionFailure_hidesInternalDetails. + */ @ExceptionHandler(ConversionFailedException.class) ResponseEntity conversionFailed(ConversionFailedException e) { + LOG.error("Конвертация не удалась", e); return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR) - .body(new ApiError(e.getMessage())); + .body(new ApiError("Не удалось конвертировать документ")); } /** Очередь конвертации занята/прерывание — повторить позже. */ diff --git a/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConversionService.java b/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConversionService.java index 3be8a3a..c4a061e 100644 --- a/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConversionService.java +++ b/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConversionService.java @@ -35,10 +35,11 @@ import java.util.concurrent.TimeoutException; * {@link ValidationException} (400), ошибка рендер-стадии → * {@link ConversionFailedException} (500). Граница: сломанный контейнер * (не zip / битый zip / слишком большой / слишком длинный) — 400; валидный - * zip с мусором внутри (нет {@code word/document.xml}) — 500: до очереди и - * в конвейере ядра вход проверяется тем же - * {@link WordPdfValidator#validate(byte[], ConvertOptions)}, поэтому уже - * принятый запрос внутренняя проверка ядра в ошибку не превратит.

+ * zip с мусором внутри (нет {@code word/document.xml}) — 500: до очереди + * проверяется только размер, корректность контейнера и число страниц — + * сериализованно внутри воркера (ядро вызывает тот же + * {@link WordPdfValidator#validate(byte[], ConvertOptions)}), поэтому + * тяжёлая проверка не занимает потоки контейнера в обход сериализации.

*/ @Service final class ConversionService { @@ -64,9 +65,9 @@ final class ConversionService { } /** - * Полный путь: синхронная валидация байтов (до очереди — от obvious-отказа - * единый воркер не должен быть занят) → постановка в очередь → ожидание - * результата с таймаутом. + * Полный путь: синхронная проверка размера (до очереди) → постановка + * в очередь → ожидание результата с таймаутом; корректность контейнера + * и число страниц проверяются сериализованно, внутри воркера (ядро). * * @throws ValidationException некорректный вход (400) * @throws ConversionFailedException ошибка ядра/рендера (500) @@ -78,14 +79,14 @@ final class ConversionService { * {@code null} не допускается (контроллер строит всегда).

*/ byte[] convert(byte[] docxBytes, String originalFilename, ConvertOptions options) { - // Бинарный .doc — не zip: .docx-валидация к нему неприменима, размер - // проверяется общим checkInput, страницы — мостом по чистому .doc - // (ядро бросит ValidationException → 400 тем же обработчиком). - if (WordPdfValidator.isBinaryDoc(docxBytes)) { - WordPdfValidator.checkInput(docxBytes, options.maxMb()); - } else { - WordPdfValidator.validate(docxBytes, options); - } + // До очереди — только дешёвый гейт размера. Полная валидация + // (контейнер + страницы — до двух полных распакованных проходов до + // 64 МБ на обоих форматах) сериализована воркером: её выполняет ядро + // внутри WordPdfConverter.convert (тот же validate с теми же + // options, ValidationException → 400 тем же путём). Синхронный + // полный validate до submit отдавал бы zip-бомбе потоки Tomcat + // в обход сериализации. + WordPdfValidator.checkInput(docxBytes, options.maxMb()); Future future; try { future = workers.submit(() -> doConvert(docxBytes, originalFilename, options)); diff --git a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java index b531562..d4ef170 100644 --- a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java +++ b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java @@ -417,8 +417,14 @@ class ConvertControllerTest { mockMvc.perform(multipart("/api/v1/convert") .file(docx("bad.docx", docxPackageWithGarbage()))) .andExpect(status().isInternalServerError()) - .andExpect(jsonPath("$.error", - org.hamcrest.Matchers.containsString("Не удалось конвертировать"))); + // фиксированный текст: сообщение ядра (docx4j/FOP/JAXB) — + // только в лог, наружу не уходит + .andExpect(jsonPath("$.error").value("Не удалось конвертировать документ")) + .andExpect(result -> { + String body = result.getResponse().getContentAsString(); + assertTrue(!body.contains("docx4j") && !body.contains("Exception"), + "500 протёк внутренними деталями: " + body); + }); } @Test