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:
+1
-1
@@ -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"]
|
||||||
|
|
||||||
|
|||||||
@@ -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 вечно. Прокси обнуляем на команде.
|
||||||
|
|||||||
@@ -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-смысл: вход не
|
||||||
|
|||||||
Reference in New Issue
Block a user