fix(core): сериализация конвертаций монитором класса WordPdfConverter
PR checks / web (pull_request) Successful in 35s
PR checks / java (pull_request) Successful in 1m19s

Публичный convert() теперь безопасен из нескольких потоков: секция после
валидации (мост .doc + convertToStream) выполняется под монитором класса —
общая FopFactory (per-render disableFontCache, имиджевые кеши) и её сброс в
finally больше не могут пересечься с параллельным рендером. warmup()
синхронизирован тем же монитором (реентельно). WordPdfValidator остаётся
до монитора: stateless, вызывается параллельно HTTP-потоками.
Регрессия — WordPdfConverterTest#concurrentConversions_twoThreadsBothSucceed.
Комментарии ConversionService/AGENTS/repo-map приведены к новому контракту.
This commit is contained in:
Pjandro
2026-11-08 14:22:56 +00:00
parent bc98a12421
commit 2116ec43a4
5 changed files with 86 additions and 30 deletions
@@ -23,13 +23,13 @@ import java.util.concurrent.TimeoutException;
/**
* Конвертация .docx-байтов в PDF-байты поверх {@code wordpdf-core}.
*
* <p>Конвертации СЕРИАЛИЗОВАНЫ однопоточным executor'ом — не «на всякий
* случай»: каждая конвертация мутирует ГЛОБАЛЬНЫЙ реестр шрифтов docx4j
* ({@code new BundledFontMapper()} заново добавляет системные шрифты
* в {@code PhysicalFonts}, {@code BundledFonts.init()/restrictToBundled()}
* их вычищают — WordPdfConverter.convertToStream, шаг 1 пайплайна). Параллельные конвертации
* вырывают реестр друг у друга из-под рендера, ядро не потокобезопасно
* by design. Регрессия — ConvertControllerTest#concurrentRequests_bothSucceed.</p>
* <p>Конвертации СЕРИАЛИЗОВАНЫ однопоточным executor'ом: он держит очередь,
* 503 при переполнении и timeout-семантику (backpressure). Само ядро при этом
* сериализует конвертации внутренним монитором ({@code WordPdfConverter.class}:
* глобальный реестр {@code PhysicalFonts}, общая FopFactory с имиджевыми
* кешами и их сброс в finally мутируются под рендером), так что параллельные
* вызовы ядра не приводят к порче вывода.
* Регрессия — ConvertControllerTest#concurrentRequests_bothSucceed.</p>
*
* <p>Ошибки разделены по смыслу (требование к API): некорректный вход →
* {@link ValidationException} (400), ошибка рендер-стадии →
@@ -55,8 +55,9 @@ final class ConversionService {
new ArrayBlockingQueue<>(QUEUE_CAPACITY));
// Прогрев ядра — головой той же однопоточной очереди: первый реальный
// запрос после деплоя становится за прогретым ядром (~50–300 мс вместо
// 1,4–1,9 с) и гарантированно сериализован с конвертациями (ядро не
// потокобезопасно). warmup() не бросает — Future никто не забирает;
// 1,4–1,9 с); сериализация прогрева с конвертациями — тем же воркером
// и монитором ядра (warmup() синхронизирован им же). warmup() не
// бросает — Future никто не забирает;
// запросы, пришедшие во время прогрева, ждут в очереди (штатная
// семантика, лимит convert-timeout с запасом).
this.workers.submit(WordPdfConverter::warmup);