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Здесь только 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-смысл: вход не