Надёжность: ConcurrentHashMap покрытия, volatile cmap, ApiKeyFilter против точечных сегментов, 413/400 из конфигурации, deleteOnExit TTF

This commit is contained in:
Pjandro
2026-10-24 21:42:29 +00:00
parent 50447aa9d0
commit f4b92f2140
9 changed files with 77 additions and 15 deletions
@@ -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,
@@ -37,7 +37,9 @@ import java.io.OutputStream;
* подменяются метрически совместимыми open-source аналогами
* (см. {@link BundledFontMapper}).
*
* Класс stateless, все методы статические.
* Класс stateless, все методы статические. Класс НЕ потокобезопасен:
* конвертации из нескольких потоков необходимо сериализовать (глобальный
* реестр {@code PhysicalFonts}, кэши шрифтов/покрытия).
*/
public final class WordPdfConverter {
@@ -146,6 +146,9 @@ public final class BundledFonts {
"Шрифт не найден в jar: " + CLASSPATH_DIR + "/" + entry.file());
}
Files.copy(in, target, StandardCopyOption.REPLACE_EXISTING);
// deleteOnExit не рекурсивен: каталог удалится только пустым,
// поэтому регистрируем каждый выгруженный TTF.
target.toFile().deleteOnExit();
} catch (IOException e) {
throw new IllegalStateException("Не удалось выгрузить шрифт " + entry.file(), e);
}
@@ -46,7 +46,7 @@ public final class GlyphFont {
private final String key;
private final TrueTypeFont ttf;
private CmapLookup cmap;
private volatile CmapLookup cmap;
private GlyphFont(String key, TrueTypeFont ttf) {
this.key = key;
@@ -75,8 +75,8 @@ public final class GlyphCoverageNormalizer {
private static final Pattern NUMERIC_ENTITY = Pattern.compile(
"&#(x?)([0-9A-Fa-f]+);");
/** Кэш покрытия: семейство -> множества проверенных/покрытых кодов. */
private static final Map<String, Coverage> COVERAGE = new HashMap<>();
/** Кэш покрытия: семейство -> множества проверенных/покрытых кодов (общий между конвертациями). */
private static final Map<String, Coverage> COVERAGE = new java.util.concurrent.ConcurrentHashMap<>();
private GlyphCoverageNormalizer() {
}
@@ -337,12 +337,8 @@ public final class GlyphCoverageNormalizer {
}
private static Coverage coverage(String family) {
Coverage c = COVERAGE.get(family);
if (c == null) {
c = new Coverage(GlyphFont.of(family, BundledFonts.V_REGULAR));
COVERAGE.put(family, c);
}
return c;
return COVERAGE.computeIfAbsent(family,
f -> new Coverage(GlyphFont.of(f, BundledFonts.V_REGULAR)));
}
/**
@@ -362,7 +358,9 @@ public final class GlyphCoverageNormalizer {
this.font = font;
}
boolean covers(int cp) {
// synchronized: BitSet не потокобезопасен (рост words[] и порядок
// checked/covered под гонкой дают ложное «не покрыт»).
synchronized boolean covers(int cp) {
if (font == null || cp < 0) {
return false;
}