Надёжность: ConcurrentHashMap покрытия, volatile cmap, ApiKeyFilter против точечных сегментов, 413/400 из конфигурации, deleteOnExit TTF
This commit is contained in:
@@ -2,6 +2,7 @@ package ru.pjandro.wordpdf.app;
|
||||
|
||||
import org.slf4j.Logger;
|
||||
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.bind.MissingServletRequestParameterException;
|
||||
@@ -9,6 +10,7 @@ import org.springframework.web.bind.annotation.ExceptionHandler;
|
||||
import org.springframework.web.bind.annotation.RestControllerAdvice;
|
||||
import org.springframework.web.multipart.MaxUploadSizeExceededException;
|
||||
import org.springframework.web.multipart.support.MissingServletRequestPartException;
|
||||
import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException;
|
||||
import org.springframework.web.servlet.resource.NoResourceFoundException;
|
||||
import ru.pjandro.wordpdf.ValidationException;
|
||||
|
||||
@@ -26,6 +28,13 @@ final class ApiExceptionHandler {
|
||||
|
||||
private static final Logger LOG = LoggerFactory.getLogger(ApiExceptionHandler.class);
|
||||
|
||||
/** Значение {@code spring.servlet.multipart.max-file-size} — для текста 413. */
|
||||
private final String maxFileSize;
|
||||
|
||||
ApiExceptionHandler(@Value("${spring.servlet.multipart.max-file-size:100MB}") String maxFileSize) {
|
||||
this.maxFileSize = maxFileSize;
|
||||
}
|
||||
|
||||
/** Тело ответа ошибки; Jackson сериализует record как есть. */
|
||||
record ApiError(String error) {
|
||||
}
|
||||
@@ -65,15 +74,16 @@ final class ApiExceptionHandler {
|
||||
}
|
||||
|
||||
/**
|
||||
* Контейнерный потолок multipart (100 МБ в application.properties)
|
||||
* Контейнерный потолок multipart ({@code spring.servlet.multipart.max-file-size})
|
||||
* сработал раньше ядра: срабатывает только на инфраструктурный лимит,
|
||||
* авторитетный (свойство {@code wordpdf.max-mb}/env {@code WORDPDF_MAX_MB})
|
||||
* проверяет {@code WordPdfValidator} и отвечает 400 своим текстом.
|
||||
* Текст берётся из свойства — не расходится с реальной конфигурацией сервера.
|
||||
*/
|
||||
@ExceptionHandler(MaxUploadSizeExceededException.class)
|
||||
ResponseEntity<ApiError> tooLarge(MaxUploadSizeExceededException e) {
|
||||
return ResponseEntity.status(HttpStatus.PAYLOAD_TOO_LARGE)
|
||||
.body(new ApiError("Файл больше 100 МБ"));
|
||||
.body(new ApiError("Файл больше " + maxFileSize + " — лимит multipart сервера"));
|
||||
}
|
||||
|
||||
/** Партита {@code file} нет в запросе — обе формы исключения возможны. */
|
||||
@@ -96,6 +106,13 @@ final class ApiExceptionHandler {
|
||||
.body(new ApiError("Не найдено"));
|
||||
}
|
||||
|
||||
/** Битое значение факультативного параметра (errorOnCharts=tru3) — ошибка клиента. */
|
||||
@ExceptionHandler(MethodArgumentTypeMismatchException.class)
|
||||
ResponseEntity<ApiError> badParam(MethodArgumentTypeMismatchException e) {
|
||||
return ResponseEntity.badRequest()
|
||||
.body(new ApiError("Некорректное значение параметра «" + e.getName() + "»"));
|
||||
}
|
||||
|
||||
/** Прочее — внутренняя ошибка; подробность только в лог, не в ответ. */
|
||||
@ExceptionHandler(Exception.class)
|
||||
ResponseEntity<ApiError> unexpected(Exception e) {
|
||||
|
||||
@@ -24,6 +24,11 @@ import java.security.MessageDigest;
|
||||
*
|
||||
* <p>Регрессии — ApiKeyFilterTest#forwardedPrefix_healthStaysOpen,
|
||||
* ApiKeyFilterTest#docsOpenWithoutKey.</p>
|
||||
*
|
||||
* <p>Путь с точечными сегментами ({@code ..}, {@code %2e}) не считается
|
||||
* открытым: контейнер матчит по сырому URI, а нормализацию {@code /actuator/../api/…}
|
||||
* может выполнить последующий обработчик — ключ спрашиваем всегда.
|
||||
* Регрессия — ApiKeyFilterTest#dotSegmentOpenPrefix_rejected.</p>
|
||||
*/
|
||||
@Component
|
||||
final class ApiKeyFilter extends OncePerRequestFilter {
|
||||
@@ -33,6 +38,10 @@ final class ApiKeyFilter extends OncePerRequestFilter {
|
||||
/** Открытые пути без ключа: actuator (HEALTHCHECK контейнера) и springdoc-документация. */
|
||||
private static final String[] OPEN_PREFIXES = {"/actuator/", "/swagger-ui", "/v3/api-docs"};
|
||||
|
||||
/** Точечные сегменты в сыром URI — не «открытый» путь (см. javadoc класса). */
|
||||
private static final String DOT_SEGMENT = "..";
|
||||
private static final String ENCODED_DOT = "%2e";
|
||||
|
||||
/** null — аутентификация выключена. */
|
||||
private final byte[] expected;
|
||||
|
||||
@@ -73,6 +82,10 @@ final class ApiKeyFilter extends OncePerRequestFilter {
|
||||
}
|
||||
|
||||
private static boolean isOpen(String path) {
|
||||
if (path.contains(DOT_SEGMENT)
|
||||
|| path.toLowerCase(java.util.Locale.ROOT).contains(ENCODED_DOT)) {
|
||||
return false;
|
||||
}
|
||||
for (String prefix : OPEN_PREFIXES) {
|
||||
if (path.startsWith(prefix)) {
|
||||
return true;
|
||||
|
||||
@@ -17,7 +17,7 @@ import static org.junit.jupiter.api.Assertions.assertFalse;
|
||||
*/
|
||||
class ApiExceptionHandlerTest {
|
||||
|
||||
private final ApiExceptionHandler handler = new ApiExceptionHandler();
|
||||
private final ApiExceptionHandler handler = new ApiExceptionHandler("100MB");
|
||||
|
||||
/** Занятая очередь — 503 с подсказкой «повторите», текст — контракт. */
|
||||
@Test
|
||||
@@ -42,7 +42,7 @@ class ApiExceptionHandlerTest {
|
||||
void tooLarge_returns413ContainerLimit() {
|
||||
var response = handler.tooLarge(new MaxUploadSizeExceededException(100L * 1024 * 1024));
|
||||
assertEquals(HttpStatus.PAYLOAD_TOO_LARGE, response.getStatusCode());
|
||||
assertEquals("Файл больше 100 МБ", response.getBody().error());
|
||||
assertEquals("Файл больше 100MB — лимит multipart сервера", response.getBody().error());
|
||||
}
|
||||
|
||||
/** Прочее исключение — 500 с общим текстом; подробность причины — только в лог. */
|
||||
|
||||
@@ -113,4 +113,18 @@ class ApiKeyFilterTest {
|
||||
mockMvc.perform(get("/v3/api-docs").header("X-Forwarded-Prefix", "/pdf-converter"))
|
||||
.andExpect(status().isOk());
|
||||
}
|
||||
|
||||
/**
|
||||
* {@code /actuator/../api/v1/convert}: фильтр матчает по сырому URI, но
|
||||
* нормализацию может выполнить последующий обработчик — путь с точечными
|
||||
* сегментами не «открытый», ключ спрашивается всегда.
|
||||
* Регрессия — ApiKeyFilterTest#dotSegmentOpenPrefix_rejected.
|
||||
*/
|
||||
@Test
|
||||
void dotSegmentOpenPrefix_rejected() throws Exception {
|
||||
mockMvc.perform(get("/actuator/../api/v1/convert"))
|
||||
.andExpect(status().isUnauthorized());
|
||||
mockMvc.perform(get(java.net.URI.create("/actuator/%2e%2e/api/v1/convert")))
|
||||
.andExpect(status().isUnauthorized());
|
||||
}
|
||||
}
|
||||
|
||||
@@ -218,6 +218,21 @@ class ConvertControllerTest {
|
||||
org.hamcrest.Matchers.containsString("OLE-объект")));
|
||||
}
|
||||
|
||||
/**
|
||||
* errorOnCharts=tru3 — некорректное значение факультативного параметра:
|
||||
* 400 с именем параметра (не 500 от catch-all).
|
||||
* Регрессия — ConvertControllerTest#errorFlagNotBoolean_rejected.
|
||||
*/
|
||||
@Test
|
||||
void errorFlagNotBoolean_rejected() throws Exception {
|
||||
mockMvc.perform(multipart("/api/v1/convert")
|
||||
.file(docx("ru-plain.docx", bytes("/samples/ru-plain.docx")))
|
||||
.param("errorOnCharts", "tru3"))
|
||||
.andExpect(status().isBadRequest())
|
||||
.andExpect(jsonPath("$.error",
|
||||
org.hamcrest.Matchers.containsString("errorOnCharts")));
|
||||
}
|
||||
|
||||
/**
|
||||
* Без параметров OLE-объекты тихо удаляются: 200, PDF.
|
||||
* Регрессия — WordPdfConverterTest#oleObjects_removedAndConverted,
|
||||
|
||||
Reference in New Issue
Block a user