OLE-объекты: переключатель errorOnOle + тихое удаление из docx
PR checks / java (pull_request) Successful in 47s
PR checks / web (pull_request) Successful in 1m6s

docx4j падает на внедрённых OLE-объектах двумя путями: JAXB-парсинг
бинарника под ложным XML-типом в [Content_Types] («Content is not
allowed in prolog» → NPE) и NPE chunkType is null в VML-сериализации
w:object. Новый OleObjectNormalizer (шестой в цепочке, после
GlyphCoverageNormalizer) удаляет OLE-bin-части, rels-ссылки, элементы
w:object и Override удалённых частей; при errorOnOle=true вместо
удаления — DrawingFoundException(OLE) → 422 «Конвертация отменена: в
документе найдены OLE-объекты».

- ядро: Kind.OLE, ConvertOptions.errorOnOle, WordPdfSettings.ERROR_ON_OLE,
  фикстура samples/ole-embedded.docx (ручная, оба механизма)
- app: параметр errorOnOle, 422-контракт, тесты errorFlagOle_rejected /
  oleObjects_removedByDefault
- SPA: третий переключатель «OLE-объекты»
- прод-автотесты: +2 проверки (21)
- регрессии: OleObjectNormalizerTest ↔ oleObjects_removedAndConverted /
  drawingErrors_errorFlagRejectsOle; E2E: notConverted.docx 500 → 200
This commit is contained in:
Pjandro
2026-10-22 21:08:18 +00:00
parent 62ae5ee164
commit 93ec325aa6
17 changed files with 718 additions and 39 deletions
@@ -36,7 +36,7 @@ final class ApiExceptionHandler {
return ResponseEntity.badRequest().body(new ApiError(e.getMessage()));
}
/** Документ содержит диаграммы/SmartArt при включённом error-флаге — вход корректен, но отвергнут по настройке. */
/** Документ содержит диаграммы/SmartArt/OLE-объекты при включённом error-флаге — вход корректен, но отвергнут по настройке. */
@ExceptionHandler(DrawingRejectedException.class)
ResponseEntity<ApiError> drawingRejected(DrawingRejectedException e) {
return ResponseEntity.status(HttpStatus.UNPROCESSABLE_ENTITY)
@@ -59,9 +59,9 @@ final class ConvertController {
}
@Operation(summary = "Конвертировать .docx в PDF",
description = "errorOnCharts/errorOnSmartArt — факультативно, по умолчанию "
description = "errorOnCharts/errorOnSmartArt/errorOnOle — факультативно, по умолчанию "
+ "настройки ядра (ошибка не выбрасывается); диаграммы/SmartArt "
+ "конвертируются всегда. "
+ "конвертируются всегда, OLE-объекты при выключенном флаге тихо удаляются. "
+ "Лимиты входа (размер/страницы) задаёт только конфигурация сервера "
+ "(свойства wordpdf.max-mb/wordpdf.max-pages), параметрами запроса не переопределяются")
@SecurityRequirement(name = OpenApiConfig.SCHEME)
@@ -72,7 +72,8 @@ final class ConvertController {
ResponseEntity<byte[]> convert(
@RequestParam("file") MultipartFile file,
@RequestParam(name = "errorOnCharts", required = false) Boolean errorOnCharts,
@RequestParam(name = "errorOnSmartArt", required = false) Boolean errorOnSmartArt) {
@RequestParam(name = "errorOnSmartArt", required = false) Boolean errorOnSmartArt,
@RequestParam(name = "errorOnOle", required = false) Boolean errorOnOle) {
if (file == null || file.isEmpty()) {
throw new ValidationException("Файл не передан (multipart-поле «file» обязательно)");
}
@@ -90,6 +91,7 @@ final class ConvertController {
ConvertOptions options = new ConvertOptions(
errorOnCharts != null ? errorOnCharts : WordPdfSettings.ERROR_ON_CHARTS,
errorOnSmartArt != null ? errorOnSmartArt : WordPdfSettings.ERROR_ON_SMARTART,
errorOnOle != null ? errorOnOle : WordPdfSettings.ERROR_ON_OLE,
maxMb, maxPages);
byte[] pdf = conversionService.convert(docxBytes, name, options);
ContentDisposition disposition = ContentDisposition.attachment()
@@ -3,7 +3,7 @@ package ru.pjandro.wordpdf.app;
import ru.pjandro.wordpdf.DrawingFoundException;
/**
* Документ содержит диаграммы/SmartArt при включённом error-флаге
* Документ содержит диаграммы/SmartArt/OLE-объекты при включённом error-флаге
* ({@link DrawingFoundException} ядра).
*
* <p>Маппится в HTTP 422 ({@link ApiExceptionHandler}); клиенту осмысленно
@@ -13,8 +13,10 @@ import ru.pjandro.wordpdf.DrawingFoundException;
class DrawingRejectedException extends RuntimeException {
DrawingRejectedException(DrawingFoundException.Kind kind) {
super(kind == DrawingFoundException.Kind.CHARTS
? "Конвертация отменена: в документе найдены диаграммы"
: "Конвертация отменена: в документе найден SmartArt");
super(switch (kind) {
case CHARTS -> "Конвертация отменена: в документе найдены диаграммы";
case SMARTART -> "Конвертация отменена: в документе найден SmartArt";
case OLE -> "Конвертация отменена: в документе найдены OLE-объекты";
});
}
}
@@ -201,6 +201,38 @@ class ConvertControllerTest {
org.hamcrest.Matchers.containsString("SmartArt")));
}
/**
* errorOnOle=true — HTTP 422 с текстом про OLE-объекты (документ валиден,
* отвергнут по настройке запроса).
* Регрессия — WordPdfConverterTest#drawingErrors_errorFlagRejectsOle,
* фикстура samples/ole-embedded.docx.
*/
@Test
void errorFlagOle_rejected() throws Exception {
mockMvc.perform(multipart("/api/v1/convert")
.file(docx("ole-embedded.docx", bytes("/samples/ole-embedded.docx")))
.param("errorOnOle", "true"))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.error",
org.hamcrest.Matchers.containsString("OLE-объект")));
}
/**
* Без параметров OLE-объекты тихо удаляются: 200, PDF.
* Регрессия — WordPdfConverterTest#oleObjects_removedAndConverted,
* фикстура samples/ole-embedded.docx.
*/
@Test
void oleObjects_removedByDefault() throws Exception {
byte[] pdf = mockMvc.perform(multipart("/api/v1/convert")
.file(docx("ole-embedded.docx", bytes("/samples/ole-embedded.docx"))))
.andExpect(status().isOk())
.andExpect(content().contentType(MediaType.APPLICATION_PDF))
.andReturn().getResponse().getContentAsByteArray();
assertTrue("%PDF".equals(new String(pdf, 0, 4, StandardCharsets.US_ASCII)),
"тело не начинается с %PDF");
}
@Test
void cyrillicAndPathInFilename_sanitizedResponseName() throws Exception {
byte[] sample = bytes("/samples/ru-plain.docx");