fix(app): 405/415 вместо catch-all 500; multipart-части на диске; heap в лимит контейнера

- 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
This commit is contained in:
Pjandro
2026-10-26 00:09:16 +00:00
parent 5beca8a61d
commit ab8ea495a8
7 changed files with 58 additions and 6 deletions
+1 -1
View File
@@ -25,5 +25,5 @@ USER app
EXPOSE 8080 EXPOSE 8080
HEALTHCHECK --interval=10s --timeout=3s --start-period=10s --retries=5 \ 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 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"]
+2
View File
@@ -12,6 +12,8 @@ services:
app: app:
build: . build: .
restart: unless-stopped restart: unless-stopped
# Паритет с compose.yml: heap вписан в лимит (-XX:MaxRAMPercentage=70).
mem_limit: 2g
# Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI, # Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI,
# где поля healthcheck нет — без явного healthcheck depends_on # где поля healthcheck нет — без явного healthcheck depends_on
# service_healthy ждал бы healthy вечно. Прокси обнуляем на команде. # service_healthy ждал бы healthy вечно. Прокси обнуляем на команде.
+3
View File
@@ -7,6 +7,9 @@ services:
app: app:
build: . build: .
restart: unless-stopped restart: unless-stopped
# Heap вписываем в лимит контейнера (-XX:MaxRAMPercentage=70 в ENTRYPOINT);
# вход 16×5 МБ очередь + FOP-рендер в 2 ГБ помещаются.
mem_limit: 2g
# Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI, # Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI,
# где поля healthcheck нет — без явного healthcheck depends_on # где поля healthcheck нет — без явного healthcheck depends_on
# service_healthy ждал бы healthy вечно. Прокси обнуляем на команде. # service_healthy ждал бы healthy вечно. Прокси обнуляем на команде.
@@ -5,6 +5,8 @@ import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Value; import org.springframework.beans.factory.annotation.Value;
import org.springframework.http.HttpStatus; import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity; 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.MissingServletRequestParameterException;
import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice; import org.springframework.web.bind.annotation.RestControllerAdvice;
@@ -20,8 +22,9 @@ import ru.pjandro.wordpdf.ValidationException;
* <p>{@link ValidationException} ядра доходит сюда напрямую — валидатор * <p>{@link ValidationException} ядра доходит сюда напрямую — валидатор
* бросает его сам; в {@link ConversionFailedException} превращается только * бросает его сам; в {@link ConversionFailedException} превращается только
* прочий {@code ru.pjandro.wordpdf.ConversionException} рендер-стадии. * прочий {@code ru.pjandro.wordpdf.ConversionException} рендер-стадии.
* Случайная утечка прочего исключения попадёт в обработчик {@link Exception} * Метод/тип содержимого не по контракту — 405/415 (иначе утонули бы в
* (500).</p> * catch-all 500). Случайная утечка прочего исключения попадёт в обработчик
* {@link Exception} (500).</p>
*/ */
@RestControllerAdvice @RestControllerAdvice
final class ApiExceptionHandler { final class ApiExceptionHandler {
@@ -113,6 +116,20 @@ final class ApiExceptionHandler {
.body(new ApiError("Некорректное значение параметра «" + e.getName() + "»")); .body(new ApiError("Некорректное значение параметра «" + e.getName() + "»"));
} }
/** Метод не поддерживается (единственный эндпоинт — POST /api/v1/convert). */
@ExceptionHandler(HttpRequestMethodNotSupportedException.class)
ResponseEntity<ApiError> methodNotSupported(HttpRequestMethodNotSupportedException e) {
return ResponseEntity.status(HttpStatus.METHOD_NOT_ALLOWED)
.body(new ApiError("Метод не поддерживается"));
}
/** Не multipart-тело запроса (application/json и т.п.). */
@ExceptionHandler(HttpMediaTypeNotSupportedException.class)
ResponseEntity<ApiError> badContentType(HttpMediaTypeNotSupportedException e) {
return ResponseEntity.status(HttpStatus.UNSUPPORTED_MEDIA_TYPE)
.body(new ApiError("Неподдерживаемый тип содержимого"));
}
/** Прочее — внутренняя ошибка; подробность только в лог, не в ответ. */ /** Прочее — внутренняя ошибка; подробность только в лог, не в ответ. */
@ExceptionHandler(Exception.class) @ExceptionHandler(Exception.class)
ResponseEntity<ApiError> unexpected(Exception e) { ResponseEntity<ApiError> unexpected(Exception e) {
@@ -25,7 +25,7 @@ import java.util.Locale;
* *
* <p>Здесь только HTTP-слой: проверка presence/расширения и формирование * <p>Здесь только HTTP-слой: проверка presence/расширения и формирование
* {@code Content-Disposition}; проверка содержимого (zip, размер, страницы) — * {@code Content-Disposition}; проверка содержимого (zip, размер, страницы) —
* зона {@link ConversionService#validate}. Ошибки в JSON-ответ переводит * зона {@link ConversionService}. Ошибки в JSON-ответ переводит
* {@link ApiExceptionHandler}. Лимиты входа — только конфигурация сервера * {@link ApiExceptionHandler}. Лимиты входа — только конфигурация сервера
* (свойства {@code wordpdf.max-mb}/{@code wordpdf.max-pages}, env * (свойства {@code wordpdf.max-mb}/{@code wordpdf.max-pages}, env
* {@code WORDPDF_MAX_MB}/{@code WORDPDF_MAX_PAGES}); параметрами запроса * {@code WORDPDF_MAX_MB}/{@code WORDPDF_MAX_PAGES}); параметрами запроса
@@ -7,10 +7,13 @@ spring.application.name=wordpdf-app
# дефолты — константы ядра (5 / 100), задаются ConvertController. # дефолты — константы ядра (5 / 100), задаются ConvertController.
# Значение <= 0 — падение на старте. Сами ключи здесь не объявлены: # Значение <= 0 — падение на старте. Сами ключи здесь не объявлены:
# пустое значение затенит SpEL-дефолт @Value. # пустое значение затенит 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-file-size=100MB
spring.servlet.multipart.max-request-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) # Таймаут одной конвертации (binding Duration в ConversionService)
wordpdf.convert-timeout=2m wordpdf.convert-timeout=2m
@@ -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.assertNotNull;
import static org.junit.jupiter.api.Assertions.assertTrue; 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.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.request.MockMvcRequestBuilders.multipart;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content; import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.header; import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.header;
@@ -417,6 +418,32 @@ class ConvertControllerTest {
org.hamcrest.Matchers.containsString("Не найдено"))); 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 IOException} из
* {@code getBytes}) — {@link ValidationException} (400-смысл: вход не * {@code getBytes}) — {@link ValidationException} (400-смысл: вход не