fix(app): полный validate внутри воркера (до очереди — только размер); 500 без деталей ядра в теле
This commit is contained in:
@@ -63,11 +63,17 @@ final class ApiExceptionHandler {
|
|||||||
.body(new ApiError(e.getMessage()));
|
.body(new ApiError(e.getMessage()));
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Ошибка ядра/рендера при формально корректном входе. */
|
/**
|
||||||
|
* Ошибка ядра/рендера при формально корректном входе. Сообщение ядра
|
||||||
|
* (тексты docx4j/FOP/JAXB, пути temp-файлов) — только в лог: наружу
|
||||||
|
* фиксированный текст, иначе 500 становится каналом внутренней информации.
|
||||||
|
* Регрессия — ConvertControllerTest#conversionFailure_hidesInternalDetails.
|
||||||
|
*/
|
||||||
@ExceptionHandler(ConversionFailedException.class)
|
@ExceptionHandler(ConversionFailedException.class)
|
||||||
ResponseEntity<ApiError> conversionFailed(ConversionFailedException e) {
|
ResponseEntity<ApiError> conversionFailed(ConversionFailedException e) {
|
||||||
|
LOG.error("Конвертация не удалась", e);
|
||||||
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
|
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
|
||||||
.body(new ApiError(e.getMessage()));
|
.body(new ApiError("Не удалось конвертировать документ"));
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Очередь конвертации занята/прерывание — повторить позже. */
|
/** Очередь конвертации занята/прерывание — повторить позже. */
|
||||||
|
|||||||
@@ -35,10 +35,11 @@ import java.util.concurrent.TimeoutException;
|
|||||||
* {@link ValidationException} (400), ошибка рендер-стадии →
|
* {@link ValidationException} (400), ошибка рендер-стадии →
|
||||||
* {@link ConversionFailedException} (500). Граница: сломанный контейнер
|
* {@link ConversionFailedException} (500). Граница: сломанный контейнер
|
||||||
* (не zip / битый zip / слишком большой / слишком длинный) — 400; валидный
|
* (не zip / битый zip / слишком большой / слишком длинный) — 400; валидный
|
||||||
* zip с мусором внутри (нет {@code word/document.xml}) — 500: до очереди и
|
* zip с мусором внутри (нет {@code word/document.xml}) — 500: до очереди
|
||||||
* в конвейере ядра вход проверяется тем же
|
* проверяется только размер, корректность контейнера и число страниц —
|
||||||
* {@link WordPdfValidator#validate(byte[], ConvertOptions)}, поэтому уже
|
* сериализованно внутри воркера (ядро вызывает тот же
|
||||||
* принятый запрос внутренняя проверка ядра в ошибку не превратит.</p>
|
* {@link WordPdfValidator#validate(byte[], ConvertOptions)}), поэтому
|
||||||
|
* тяжёлая проверка не занимает потоки контейнера в обход сериализации.</p>
|
||||||
*/
|
*/
|
||||||
@Service
|
@Service
|
||||||
final class ConversionService {
|
final class ConversionService {
|
||||||
@@ -64,9 +65,9 @@ final class ConversionService {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Полный путь: синхронная валидация байтов (до очереди — от obvious-отказа
|
* Полный путь: синхронная проверка размера (до очереди) → постановка
|
||||||
* единый воркер не должен быть занят) → постановка в очередь → ожидание
|
* в очередь → ожидание результата с таймаутом; корректность контейнера
|
||||||
* результата с таймаутом.
|
* и число страниц проверяются сериализованно, внутри воркера (ядро).
|
||||||
*
|
*
|
||||||
* @throws ValidationException некорректный вход (400)
|
* @throws ValidationException некорректный вход (400)
|
||||||
* @throws ConversionFailedException ошибка ядра/рендера (500)
|
* @throws ConversionFailedException ошибка ядра/рендера (500)
|
||||||
@@ -78,14 +79,14 @@ final class ConversionService {
|
|||||||
* {@code null} не допускается (контроллер строит всегда).</p>
|
* {@code null} не допускается (контроллер строит всегда).</p>
|
||||||
*/
|
*/
|
||||||
byte[] convert(byte[] docxBytes, String originalFilename, ConvertOptions options) {
|
byte[] convert(byte[] docxBytes, String originalFilename, ConvertOptions options) {
|
||||||
// Бинарный .doc — не zip: .docx-валидация к нему неприменима, размер
|
// До очереди — только дешёвый гейт размера. Полная валидация
|
||||||
// проверяется общим checkInput, страницы — мостом по чистому .doc
|
// (контейнер + страницы — до двух полных распакованных проходов до
|
||||||
// (ядро бросит ValidationException → 400 тем же обработчиком).
|
// 64 МБ на обоих форматах) сериализована воркером: её выполняет ядро
|
||||||
if (WordPdfValidator.isBinaryDoc(docxBytes)) {
|
// внутри WordPdfConverter.convert (тот же validate с теми же
|
||||||
|
// options, ValidationException → 400 тем же путём). Синхронный
|
||||||
|
// полный validate до submit отдавал бы zip-бомбе потоки Tomcat
|
||||||
|
// в обход сериализации.
|
||||||
WordPdfValidator.checkInput(docxBytes, options.maxMb());
|
WordPdfValidator.checkInput(docxBytes, options.maxMb());
|
||||||
} else {
|
|
||||||
WordPdfValidator.validate(docxBytes, options);
|
|
||||||
}
|
|
||||||
Future<byte[]> future;
|
Future<byte[]> future;
|
||||||
try {
|
try {
|
||||||
future = workers.submit(() -> doConvert(docxBytes, originalFilename, options));
|
future = workers.submit(() -> doConvert(docxBytes, originalFilename, options));
|
||||||
|
|||||||
@@ -417,8 +417,14 @@ class ConvertControllerTest {
|
|||||||
mockMvc.perform(multipart("/api/v1/convert")
|
mockMvc.perform(multipart("/api/v1/convert")
|
||||||
.file(docx("bad.docx", docxPackageWithGarbage())))
|
.file(docx("bad.docx", docxPackageWithGarbage())))
|
||||||
.andExpect(status().isInternalServerError())
|
.andExpect(status().isInternalServerError())
|
||||||
.andExpect(jsonPath("$.error",
|
// фиксированный текст: сообщение ядра (docx4j/FOP/JAXB) —
|
||||||
org.hamcrest.Matchers.containsString("Не удалось конвертировать")));
|
// только в лог, наружу не уходит
|
||||||
|
.andExpect(jsonPath("$.error").value("Не удалось конвертировать документ"))
|
||||||
|
.andExpect(result -> {
|
||||||
|
String body = result.getResponse().getContentAsString();
|
||||||
|
assertTrue(!body.contains("docx4j") && !body.contains("Exception"),
|
||||||
|
"500 протёк внутренними деталями: " + body);
|
||||||
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
|
|||||||
Reference in New Issue
Block a user