fix(产品风险结果文件): 表头样式改在 SXSSF flush 之前施加,大结果集不再永久卡死

现网证据(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` 与注入前逐字节一致。
This commit is contained in:
2026-10-08 20:53:27 +08:00
parent 9d762c552a
commit 85b6bdd152
2 changed files with 42 additions and 1 deletions
@@ -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)} 拿到的是 <b>null</b>,
* {@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)。
*
* <p>断言打在两件事上:文件真的一次写成了(行数完整),而且表头样式仍然落在 6..8 列上——
* 前者挡住"改成不抛异常但把表头样式整段丢掉"那种假修。</p>
*/
@Test
void writesWholeWorkbookWhenRowsExceedTheSxssfFlushWindow() throws Exception {
Path xlsx = Files.createTempFile("product-risk-over-window-", ".xlsx");
try {
List<ProductRiskRowDto> 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");