From 85b6bdd152149996ee554e2049ad04da2099e1a4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Thu, 8 Oct 2026 20:53:27 +0800 Subject: [PATCH] =?UTF-8?q?fix(=E4=BA=A7=E5=93=81=E9=A3=8E=E9=99=A9?= =?UTF-8?q?=E7=BB=93=E6=9E=9C=E6=96=87=E4=BB=B6):=20=E8=A1=A8=E5=A4=B4?= =?UTF-8?q?=E6=A0=B7=E5=BC=8F=E6=94=B9=E5=9C=A8=20SXSSF=20flush=20?= =?UTF-8?q?=E4=B9=8B=E5=89=8D=E6=96=BD=E5=8A=A0=EF=BC=8C=E5=A4=A7=E7=BB=93?= =?UTF-8?q?=E6=9E=9C=E9=9B=86=E4=B8=8D=E5=86=8D=E6=B0=B8=E4=B9=85=E5=8D=A1?= =?UTF-8?q?=E6=AD=BB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 现网证据(10-08 19:42,biz_task_file_job):job 21603 / task 30219 / user 983 的 ASSEMBLE_RESULT FAILED,error_message 是 `generate product-risk excel failed: Cannot invoke "Row.getCell(int)" because "headerRow" is null`,retry_count=5 全是同一个错; 10-07 20:55 的 job 21549 是同一条错 ⇒ 不是这次重启弄的,是早就存在的确定性缺陷,只是没人归因过。 机制:SxssfWorkbookWriter 用的是 SXSSF(流式,行访问窗口 200)。 `writeWorkbook` 在把整批数据行写完之后才 `applyDetailHeaderStyle(sheet.getRow(0), detailStyle)`, 而数据一超过 200 行,第 0 行早被 flush 出内存,`getRow(0)` 回读到 null,逐格取样式就 NPE; 外层 `catch (Exception)` 把它吞成一条业务失败文案,于是**结果集小的任务正常、大的永远出不来文件**, 任务一直挂 RUNNING。所以这条 bug 只在行数跨过分界时出现,跟数据内容无关。 修法是把那一次表头样式施加挪到写数据之前(createSheet 刚建好第 0 行,必然在窗口内), 一行位置变动,样式范围(6..8 列)与语义都不动。 验证:先写复现用例(260 行 > 窗口)⇒ 红,且报错文字与现网逐字一致;挪位置后 5/5 绿、 `ProductRiskTaskServiceTest` 5 例同绿(共 10 例 0 红)。变异自证 3/3 被杀: M1 把调用挪回循环之后(生产原样)1 红、M2 整行删掉调用 1 红(断言同时钉住"样式还在", 不许只钉"不抛异常")、M3 把 6..8 悄悄缩成只第 6 列 1 红;三轮还原后文件哈希 `68c32f8ef2c0` 与注入前逐字节一致。 --- .../ProductRiskExcelAssemblyService.java | 4 +- .../ProductRiskExcelAssemblyServiceTest.java | 39 +++++++++++++++++++ 2 files changed, 42 insertions(+), 1 deletion(-) diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/productrisk/service/ProductRiskExcelAssemblyService.java b/backend-java/src/main/java/com/nanri/aiimage/modules/productrisk/service/ProductRiskExcelAssemblyService.java index 9619bd6fe..ae5600cd4 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/productrisk/service/ProductRiskExcelAssemblyService.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/productrisk/service/ProductRiskExcelAssemblyService.java @@ -51,6 +51,9 @@ public class ProductRiskExcelAssemblyService { List rows = safe.getOrDefault(sheetName, List.of()); CellStyle detailStyle = createDetailStyle(workbook); CellStyle detailAsinStyle = createDetailAsinStyle(workbook); + // 表头样式必须在写数据之前施加:SXSSF 是流式的,窗口只有 200 行, + // 数据一超过这个数第 0 行就被 flush 出内存,此后 sheet.getRow(0) 回读到的是 null。 + applyDetailHeaderStyle(sheet.getRow(0), detailStyle); int rowIdx = 1; for (ProductRiskRowDto dto : rows) { List details = violationDetails(dto); @@ -80,7 +83,6 @@ public class ProductRiskExcelAssemblyService { } rowIdx += groupSize; } - applyDetailHeaderStyle(sheet.getRow(0), detailStyle); applyDefaultColumnWidths(sheet); } writer.write(outputXlsx); diff --git a/backend-java/src/test/java/com/nanri/aiimage/modules/productrisk/service/ProductRiskExcelAssemblyServiceTest.java b/backend-java/src/test/java/com/nanri/aiimage/modules/productrisk/service/ProductRiskExcelAssemblyServiceTest.java index 8a91fee24..763d9e52b 100644 --- a/backend-java/src/test/java/com/nanri/aiimage/modules/productrisk/service/ProductRiskExcelAssemblyServiceTest.java +++ b/backend-java/src/test/java/com/nanri/aiimage/modules/productrisk/service/ProductRiskExcelAssemblyServiceTest.java @@ -3,6 +3,7 @@ package com.nanri.aiimage.modules.productrisk.service; import com.fasterxml.jackson.databind.ObjectMapper; import com.nanri.aiimage.modules.productrisk.model.dto.ProductRiskRowDto; import com.nanri.aiimage.modules.productrisk.model.enums.ProductRiskCountryCode; +import org.apache.poi.ss.usermodel.BorderStyle; import org.apache.poi.ss.usermodel.Sheet; import org.apache.poi.ss.usermodel.Workbook; import org.apache.poi.ss.util.CellRangeAddress; @@ -25,6 +26,44 @@ class ProductRiskExcelAssemblyServiceTest { private final ProductRiskExcelAssemblyService service = new ProductRiskExcelAssemblyService(); + /** + * 复现生产那支永久卡住的作业(10-08 现网 job 21603 / task 30219 / user 983): + * 结果集一旦超过 SXSSF 的 200 行窗口,第 0 行就被 flush 出内存, + * 数据写完之后再 {@code sheet.getRow(0)} 拿到的是 null, + * {@code applyDetailHeaderStyle} 直接 NPE,被外层 {@code catch (Exception)} 吞成 + * "generate product-risk excel failed: Cannot invoke Row.getCell(int) because headerRow is null", + * 于是重试 5 次全是同一个错、任务永远停在 RUNNING、结果文件永远出不来(同族还有 10-07 的 job 21549)。 + * + *

断言打在两件事上:文件真的一次写成了(行数完整),而且表头样式仍然落在 6..8 列上—— + * 前者挡住"改成不抛异常但把表头样式整段丢掉"那种假修。

+ */ + @Test + void writesWholeWorkbookWhenRowsExceedTheSxssfFlushWindow() throws Exception { + Path xlsx = Files.createTempFile("product-risk-over-window-", ".xlsx"); + try { + List rows = new java.util.ArrayList<>(); + for (int i = 0; i < 260; i++) { + rows.add(row("B0WINDOW" + i, "处理完成", Boolean.FALSE)); + } + + service.writeWorkbook( + xlsx.toFile(), "店铺A", + Map.of(ProductRiskCountryCode.DE.getSheetName(), rows)); + + try (InputStream in = Files.newInputStream(xlsx); + Workbook workbook = new XSSFWorkbook(in)) { + Sheet sheet = workbook.getSheet(ProductRiskCountryCode.DE.getSheetName()); + assertNotNull(sheet, "工作表没出来"); + assertEquals(260, sheet.getLastRowNum(), "260 行数据 + 第 0 行表头,一行都不该少"); + assertEquals(BorderStyle.THIN, sheet.getRow(0).getCell(7).getCellStyle().getBorderTop(), + "表头 6..8 列的细边框必须还在(修法只是把它挪到 flush 之前,不是删掉)"); + assertEquals("原因", sheet.getRow(0).getCell(7).getStringCellValue()); + } + } finally { + Files.deleteIfExists(xlsx); + } + } + @Test void completionColumnUsesChineseValueAndCompletedStatusWinsOverFalseDone() throws Exception { Path xlsx = Files.createTempFile("product-risk-result-", ".xlsx");