fix(summary): 修 2026-07 导出件「Excel 打不开」+ 补齐 7 月母版 2021/2022/2023 累计列

zhizhijie

2026-09-16 80e08795ef502404dd4e343a9779c68cd8567846

 docs/ÎÊÌâ»ã×Ü/ÎÊÌâÓë×¢ÒâÊÂÏî»ã×Ü_2026-09-16.md

@@ -243,3 +243,47 @@
| 12 | æ¯ç‰ˆç» Excel é‡å­˜åŽä½“积 959,706 -> 1,492,121 å­—节（导出件 950,186 -> 1,331,599） | çº¯æ ¼å¼å¼€é”€ï¼Œæ•°æ®æ— å½±å“ | è®°å½• |

详见《功能测试报告/功能测试报告_货运页签累计列修复与脏期清理_2026-09-16.md》。

---

## åä¸‰ã€2026-09-16 è¡¥å……：2026-07 æ¯ç‰ˆè¡¥é½ & å¯¼å‡ºä»¶ã€ŒExcel æ‰“不开」根因（P0）

### 13.1 ç—‡çŠ¶ä¸Žæ ¹å› 

| é¡¹ | å†…容 |
|---|---|
| ç—‡çŠ¶ | `GET /api/report/export/summaryWorkbook?period=2026-07&mode=month` ç”Ÿæˆçš„ xlsx，**Excel æ‰“不开**（COM æŠ¥ã€Œä¸èƒ½å–å¾—ç±» Workbooks çš„ Open å±žæ€§ã€ï¼›`CorruptLoad=1` ä¿®å¤æ¨¡å¼åŒæ ·æ‰“不开）；2026-08 åŒæŽ¥å£æ­£å¸¸ |
| ç›´æŽ¥åŽŸå›  | å¯¼å‡ºä»¶é‡Œæœ‰ **19 ä¸ªæ¨¡å¼éžæ³•æ ¼**：`<c r="E15" s="111" t="n"><v>67.0</v><is><t>67.00</t></is></c>` â€”— `t="n"` ä¸å…è®¸å¸¦ `<is>`（inlineStr ä¸“用） |
| æ·±å±‚原因 | 7 æœˆæ¯ç‰ˆç”± **openpyxl** å†™å‡ºï¼ˆ`docProps/app.xml` = `Microsoft Excel Compatible / Openpyxl 3.1.5`，文本存 `<is>`）；8 æœˆæ¯ç‰ˆæ˜¯ **Excel åŽŸç”Ÿ**（文本走 sharedStrings）。POI çš„部分写入路径只改 `t`/`<v>`、不清旧 `<is>` |
| è§¦å‘路径 | 7 æœˆå­˜åœ¨ `_备份_2026å¹´7月道路运输量汇总表_清理前_20260904.xlsx` â†’ `restoreSummaryMonthlyBlocks` æ•´æ ¼å›žå¡« â†’ å¾€ inlineStr æ ¼é‡Œå†™å€¼ç•™ä¸‹æ—§ `<is>`。8 æœˆæ—  `_备份_*`，不走回填，故正常 |
| å‘½ä¸­ä½ç½® | leave-one-out å®šä½åˆ° **sheet9《公交》17 æ ¼ + sheet12《轨道、轮渡》2 æ ¼** |

### 13.2 ä¿®å¤ï¼ˆ`traffic-audit-server`）

1. **`exportSummaryWorkbook` æ–°å¢ž `normalizeStaleInlineStrings(wb)`**：落盘前清掉所有「非 `inlineStr` å´æ®‹ç•™ `<is>`」的格子（幂等），命中即打 warn æ—¥å¿—。
2. **`restoreSummaryMonthlyBlocks` æ–°å¢ž `skipFreightHistoryBlocks`**：《 è´§è¿ã€‹é¡µ **T åˆ—及以后**（2025/2024/2023/2022/2021 å¹´åº¦å— + å„年累计/累计同比列）**永不从备份母版回填** â€”— ä¸Žæ—¢æœ‰ã€Œä¸­å£å¾„排名左块永不回填」同一思路，避免补齐被「生成又复活」。

### 13.3 2026-07 æ¯ç‰ˆè¡¥é½ï¼ˆå£å¾„与 8 æœˆæ¯ç‰ˆå¯¹é½ï¼‰

- å¹´åº¦å—（每列）：`r7/r9/r8/r10 = SUM(17 å¸‚州对应行)`、`r5 = r7+r9`、`r6 = r8+r10` â†’ 360 æ ¼ï¼›
- ç´¯è®¡åˆ—：`DX = SUM(DK:DV)`（2022）、`EM = SUM(EA:EL)`（2021，原**整列为空**）、`DY = IFERROR(DX/SUM(EA:EL)-1,"")`（2022 ç´¯è®¡åŒæ¯”，原为**写死常量**）→ 324 æ ¼ï¼›
- 2023 ç´¯è®¡ `CU = BW+BY+…+CS` æœ¬æ¥å°±æ­£ç¡®ï¼Œæœªæ”¹ï¼›`EN`（2021 ç´¯è®¡åŒæ¯”）按口径保持为空。
- ä¸€æ‰‹è¯æ®ï¼šæ¯ç‰ˆ `DX5=144979.2825`（旧常量 `144979.285376043`，差 0.0029 = å…¨çœè§„下常量与 17 å¸‚州之和的差）、`EM5=161309.53162`、`CU5=173045.296428512`，与 8 æœˆæ¯ç‰ˆ `DZ5/EO5/CW5` **完全相等**。
- å¤‡ä»½ï¼š`docs/生成汇总大表/_bak_2026å¹´7月道路运输量汇总表_补齐前_20260916.xlsx`。**切勿改名为 `_备份_` å¼€å¤´**，否则会被 `resolveSummaryDonor` å½“ donor å›žå¡«ã€‚

### 13.4 æœ¬æ¬¡æ–°å¢žçš„排查坑

| é—®é¢˜ | åŽŸå›  | å¤„ç½® |
|---|---|---|
| Excel COM **间歇性**报同一个错，导致误判「8 æœˆä»¶ä¹Ÿæ‰“不开」 | æ¯æ¬¡ `New-Object -ComObject Excel.Application` ç•™ä¸‹çš„**孤儿 EXCEL è¿›ç¨‹**会污染后续实例 | æ¯ä¾‹æµ‹å®ŒæŠŠã€Œæœ¬æ¬¡æ–°å»ºçš„ EXCEL è¿›ç¨‹ã€å¼ºæ€å†æµ‹ä¸‹ä¸€ä¾‹ï¼›`Quit()`+`ReleaseComObject` å¹¶ä¸å¤Ÿ |
| ç¼–译报「找不到 isSetSheetData()」 | `CTWorksheet.sheetData` æ˜¯ XSD **必填**元素，不生成 `isSetXxx` | æ”¹ç”¨ `ctw.getSheetData() != null` |
| éƒ¨ä»¶çº§ diff å¤ªå¤§è·‘不动 | å¯¹ 519KB çš„ `styles.xml` ç›´æŽ¥ `difflib` æ˜¯ O(n²) | å…ˆæŒ‰éƒ¨ä»¶æ¯”字节尺寸/是否相等，只在必要的小部件上做 diff |

### 13.5 é—留问题增量

| # | é—®é¢˜ | å½±å“ | çŠ¶æ€ |
|---|---|---|---|
| 13 | 2026-06 / 2026-09 æ— æ¯ç‰ˆ | é¢„览 `ready=False`「未找到模板文件」，无法出数 | éœ€å…ˆå»ºæ¯ç‰ˆï¼ˆç”¨æˆ·ç¬¬ 5 é—®çš„延伸） |
| 14 | ä»“库根 `_*.*` ä¸´æ—¶æ–‡ä»¶ç»§ç»­å¢žå¤šï¼ˆ`_hyb_*` / `_loo_*` / `_v2_*` / `_final_*` / `_fixed_*` / `_t7_*` / `_poijar`） | ä½“积/可读性 | ç»ç”¨æˆ·åŒæ„åŽå†æ¸…理 |

> ç¬¬ 10 é¡¹ï¼ˆ2026-07 å¯¼å‡ºä»¶å°‘ 2 åˆ— / 7 æœˆæ¯ç‰ˆæ˜¯ã€Œ1-4 æœˆéª¨æž¶ã€ï¼‰æœ¬èŠ‚已处理：导出端会**自动补出 5/6/7 æœˆè¡¨å¤´ä¸Žå…¬å¼**并重算累计公式，母版已补齐 2021/2022/2023 ç´¯è®¡åˆ—，故关闭该项。