From ab8ea495a8bf5e57eb72303df9bcbf2c15f92a29 Mon Sep 17 00:00:00 2001 From: Pjandro Date: Mon, 26 Oct 2026 00:09:16 +0000 Subject: [PATCH] =?UTF-8?q?fix(app):=20405/415=20=D0=B2=D0=BC=D0=B5=D1=81?= =?UTF-8?q?=D1=82=D0=BE=20catch-all=20500;=20multipart-=D1=87=D0=B0=D1=81?= =?UTF-8?q?=D1=82=D0=B8=20=D0=BD=D0=B0=20=D0=B4=D0=B8=D1=81=D0=BA=D0=B5;?= =?UTF-8?q?=20heap=20=D0=B2=20=D0=BB=D0=B8=D0=BC=D0=B8=D1=82=20=D0=BA?= =?UTF-8?q?=D0=BE=D0=BD=D1=82=D0=B5=D0=B9=D0=BD=D0=B5=D1=80=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - ApiExceptionHandler: HttpRequestMethodNotSupportedException → 405, HttpMediaTypeNotSupportedException → 415 (JSON-контракт {error: …}) - file-size-threshold 100MB→2MB: части > 2 МБ на диск Tomcat, heap держит только getBytes() одной сериализованной конвертации (раньше каждая параллельная загрузка буферизовалась в heap до валидации размера) - Containerfile ENTRYPOINT: -XX:MaxRAMPercentage=70; compose/compose.dev/ прод-рендер: mem_limit: 2g у app - ConvertController javadoc: ссылки на несуществующий ConversionService#validate нет - Регрессии — ConvertControllerTest#methodNotSupportedReturns405/badContentTypeReturns415 --- Containerfile | 2 +- compose.dev.yml | 2 ++ compose.yml | 3 +++ .../wordpdf/app/ApiExceptionHandler.java | 21 +++++++++++++-- .../wordpdf/app/ConvertController.java | 2 +- .../src/main/resources/application.properties | 7 +++-- .../wordpdf/app/ConvertControllerTest.java | 27 +++++++++++++++++++ 7 files changed, 58 insertions(+), 6 deletions(-) diff --git a/Containerfile b/Containerfile index 7ccb58c..7784050 100644 --- a/Containerfile +++ b/Containerfile @@ -25,5 +25,5 @@ USER app EXPOSE 8080 HEALTHCHECK --interval=10s --timeout=3s --start-period=10s --retries=5 \ CMD HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1 -ENTRYPOINT ["java", "-Djava.awt.headless=true", "-jar", "/app/app.jar"] +ENTRYPOINT ["java", "-Djava.awt.headless=true", "-XX:MaxRAMPercentage=70", "-jar", "/app/app.jar"] diff --git a/compose.dev.yml b/compose.dev.yml index a0138af..1147700 100644 --- a/compose.dev.yml +++ b/compose.dev.yml @@ -12,6 +12,8 @@ services: app: build: . restart: unless-stopped + # Паритет с compose.yml: heap вписан в лимит (-XX:MaxRAMPercentage=70). + mem_limit: 2g # Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI, # где поля healthcheck нет — без явного healthcheck depends_on # service_healthy ждал бы healthy вечно. Прокси обнуляем на команде. diff --git a/compose.yml b/compose.yml index fd075d3..27337e3 100644 --- a/compose.yml +++ b/compose.yml @@ -7,6 +7,9 @@ services: app: build: . restart: unless-stopped + # Heap вписываем в лимит контейнера (-XX:MaxRAMPercentage=70 в ENTRYPOINT); + # вход 16×5 МБ очередь + FOP-рендер в 2 ГБ помещаются. + mem_limit: 2g # Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI, # где поля healthcheck нет — без явного healthcheck depends_on # service_healthy ждал бы healthy вечно. Прокси обнуляем на команде. 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 8a2bc14..7c6fe87 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 @@ -5,6 +5,8 @@ import org.slf4j.LoggerFactory; import org.springframework.beans.factory.annotation.Value; import org.springframework.http.HttpStatus; import org.springframework.http.ResponseEntity; +import org.springframework.web.HttpMediaTypeNotSupportedException; +import org.springframework.web.HttpRequestMethodNotSupportedException; import org.springframework.web.bind.MissingServletRequestParameterException; import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.RestControllerAdvice; @@ -20,8 +22,9 @@ import ru.pjandro.wordpdf.ValidationException; *

{@link ValidationException} ядра доходит сюда напрямую — валидатор * бросает его сам; в {@link ConversionFailedException} превращается только * прочий {@code ru.pjandro.wordpdf.ConversionException} рендер-стадии. - * Случайная утечка прочего исключения попадёт в обработчик {@link Exception} - * (500).

+ * Метод/тип содержимого не по контракту — 405/415 (иначе утонули бы в + * catch-all 500). Случайная утечка прочего исключения попадёт в обработчик + * {@link Exception} (500).

*/ @RestControllerAdvice final class ApiExceptionHandler { @@ -113,6 +116,20 @@ final class ApiExceptionHandler { .body(new ApiError("Некорректное значение параметра «" + e.getName() + "»")); } + /** Метод не поддерживается (единственный эндпоинт — POST /api/v1/convert). */ + @ExceptionHandler(HttpRequestMethodNotSupportedException.class) + ResponseEntity methodNotSupported(HttpRequestMethodNotSupportedException e) { + return ResponseEntity.status(HttpStatus.METHOD_NOT_ALLOWED) + .body(new ApiError("Метод не поддерживается")); + } + + /** Не multipart-тело запроса (application/json и т.п.). */ + @ExceptionHandler(HttpMediaTypeNotSupportedException.class) + ResponseEntity badContentType(HttpMediaTypeNotSupportedException e) { + return ResponseEntity.status(HttpStatus.UNSUPPORTED_MEDIA_TYPE) + .body(new ApiError("Неподдерживаемый тип содержимого")); + } + /** Прочее — внутренняя ошибка; подробность только в лог, не в ответ. */ @ExceptionHandler(Exception.class) ResponseEntity unexpected(Exception e) { diff --git a/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConvertController.java b/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConvertController.java index 6f73706..c6488aa 100644 --- a/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConvertController.java +++ b/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConvertController.java @@ -25,7 +25,7 @@ import java.util.Locale; * *

Здесь только HTTP-слой: проверка presence/расширения и формирование * {@code Content-Disposition}; проверка содержимого (zip, размер, страницы) — - * зона {@link ConversionService#validate}. Ошибки в JSON-ответ переводит + * зона {@link ConversionService}. Ошибки в JSON-ответ переводит * {@link ApiExceptionHandler}. Лимиты входа — только конфигурация сервера * (свойства {@code wordpdf.max-mb}/{@code wordpdf.max-pages}, env * {@code WORDPDF_MAX_MB}/{@code WORDPDF_MAX_PAGES}); параметрами запроса diff --git a/wordpdf-app/src/main/resources/application.properties b/wordpdf-app/src/main/resources/application.properties index 8b271a4..5b201fa 100644 --- a/wordpdf-app/src/main/resources/application.properties +++ b/wordpdf-app/src/main/resources/application.properties @@ -7,10 +7,13 @@ spring.application.name=wordpdf-app # дефолты — константы ядра (5 / 100), задаются ConvertController. # Значение <= 0 — падение на старте. Сами ключи здесь не объявлены: # пустое значение затенит SpEL-дефолт @Value. -# file-size-threshold=100MB держит файл в памяти (ядро и так читает всё в RAM). +# file-size-threshold=2MB: части больше 2 МБ сбрасываются на диск Tomcat, heap +# держит только копию getBytes() одной сериализованной конвертации (порог 100MB +# буферизовал в heap каждую параллельную загрузку до валидации размера — OOM-килл +# контейнера). spring.servlet.multipart.max-file-size=100MB spring.servlet.multipart.max-request-size=100MB -spring.servlet.multipart.file-size-threshold=100MB +spring.servlet.multipart.file-size-threshold=2MB # Таймаут одной конвертации (binding Duration в ConversionService) wordpdf.convert-timeout=2m 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 65a542b..06d58f9 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 @@ -33,6 +33,7 @@ import static org.junit.jupiter.api.Assertions.assertThrows; import static org.junit.jupiter.api.Assertions.assertNotNull; import static org.junit.jupiter.api.Assertions.assertTrue; import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post; import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.multipart; import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content; import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.header; @@ -417,6 +418,32 @@ class ConvertControllerTest { org.hamcrest.Matchers.containsString("Не найдено"))); } + /** + * GET на единственный POST-эндпоинт — 405 с JSON-текстом от + * {@code ApiExceptionHandler}, а не 500 от catch-all. + * Регрессия — ConvertControllerTest#methodNotSupportedReturns405. + */ + @Test + void methodNotSupportedReturns405() throws Exception { + mockMvc.perform(get("/api/v1/convert")) + .andExpect(status().isMethodNotAllowed()) + .andExpect(jsonPath("$.error").value("Метод не поддерживается")); + } + + /** + * POST с не-multipart телом (application/json) — 415 с JSON-текстом, + * не 500 от catch-all. + * Регрессия — ConvertControllerTest#badContentTypeReturns415. + */ + @Test + void badContentTypeReturns415() throws Exception { + mockMvc.perform(post("/api/v1/convert") + .contentType(MediaType.APPLICATION_JSON) + .content("{}")) + .andExpect(status().isUnsupportedMediaType()) + .andExpect(jsonPath("$.error").value("Неподдерживаемый тип содержимого")); + } + /** * Отказ чтения партиты контейнером ({@code IOException} из * {@code getBytes}) — {@link ValidationException} (400-смысл: вход не