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