功能测试报告 — 2026-07 母版补齐 & 导出件「Excel 打不开」修复

日期：2026-09-16
范围：汇总大表（/api/report/export/summaryWorkbook）2026-07 / 2026-08 导出；docs/生成汇总大表/2026年7月道路运输量汇总表.xlsx 母版补齐
关联：docs/问题汇总/问题与注意事项汇总_2026-09-16.md 第十三节

一、背景

《货运》页「累计」列口径在 2026-09-16 已在 8 月母版 落地（见第十二节）。用户确认「可以补齐」，要求把同一口径补到 7 月母版，并解决 7 月导出件无法用 Excel 打开的问题。

二、测试环境

项	值
后端	Spring Boot，8090（修复后已重启）
前端	Vue，8080
数据库	MySQL 127.0.0.1:3308 / traffic_audit
Excel 判据	Excel COM `Workbooks.Open`（每例独立实例，测后强杀孤儿进程）
结构判据	Python `zipfile` + `xml.etree` 逐部件校验、逐格 `<c>` 解析

三、发现的根因（两处，均为本次修复对象）

3.1 导出件打不开：残留 `<is>` 的非法单元格

坏件里存在 19 个**模式非法**的格子：

<c r="E15" s="111" t="n"><v>67.0</v><is><t>67.00</t></is></c>

<is>（inlineStr）只允许出现在 t="inlineStr" 的格里；t="n" 却带 <is> 属于非法，Excel 直接判定「无法读取的内容」拒绝打开（COM 表现为「不能取得类 Workbooks 的 Open 属性」，连修复模式 CorruptLoad=1 也打不开）。

成因：7 月母版由 openpyxl 写出（docProps/app.xml = Microsoft Excel Compatible / Openpyxl 3.1.5，文本用 <is> 存储）。导出时别的写入路径只改 t/<v>，**不清旧 <is>**；而 8 月母版是 Excel 原生（文本走 sharedStrings），所以同样代码下 8 月件正常、7 月件坏。

为什么只有 7 月坏：7 月存在同期备份母版 _备份_2026年7月道路运输量汇总表_清理前_20260904.xlsx，restoreSummaryMonthlyBlocks 会整格回填；回填写入 inlineStr 母版格时留下旧 <is>。8 月没有该 _备份_* 文件，不走回填，因此不触发。

定位方法（可复用）：坏件与好件除 worksheets/styles/sharedStrings 外**全部部件逐字节相同** → 用 zip 杂交 + Excel 逐一开档做 leave-one-out，定位到 sheet9《公交》(17 格) + sheet12《轨道、轮渡》(2 格)。

3.2 母版补齐被备份母版「生成又复活」

补好 7 月母版后导出，货运 页 2022/2021 累计**又变回旧写死常量** —— 因为 restoreSummaryMonthlyBlocks 把备份母版（清理前、仍是旧常量）整格回填覆盖了母版的新公式。

四、修复内容

#	位置	改动
1	`ReportExportService.exportSummaryWorkbook`	落盘前新增 `normalizeStaleInlineStrings(wb)`：把所有「非 inlineStr 却残留 `<is>`」的格子清掉（幂等），并打 warn 日志
2	`ReportExportService.restoreSummaryMonthlyBlocks`	新增 `skipFreightHistoryBlocks`：《货运》页 T 列及以后（2025/2024/2023/2022/2021 年度块 + 各年累计/累计同比列）永不从备份母版回填，避免“生成又复活”（与既有「中口径排名」左块保护同一思路）
3	`docs/生成汇总大表/2026年7月道路运输量汇总表.xlsx`	Excel COM 补齐：2025/2024/2023/2022/2021 五个年度块共 360 个块内格（`r7/r9/r8/r10 = SUM(17 市州)`、`r5=r7+r9`、`r6=r8+r10`）+ 324 个累计格（`DX=SUM(DK:DV)`、`EM=SUM(EA:EL)`、`DY=IFERROR(DX/SUM(EA:EL)-1,"")`），`CalculateFullRebuild` 后保存

备份：docs/生成汇总大表/_bak_2026年7月道路运输量汇总表_补齐前_20260916.xlsx（**故意不用 _备份_ 前缀**，否则会被 resolveSummaryDonor 当成 donor 回填）。

五、用例表

#	用例	输入	预期	实际	结论
1	坏件复现	2026-07 导出（修复前）	可打开	Excel 报「不能取得类 Workbooks 的 Open 属性」，重试 2 次仍失败	复现
2	环境排除	10KB 小件 / 8 月母版 / 7 月母版 / 09-08 旧 7 月导出	—	全部可打开；仅新 7 月导出失败	确认非环境问题
3	路径排除	坏件复制到另一目录改名	仍失败	仍失败	确认是文件内容问题
4	部件级杂交	坏件 + 好件的 styles/sharedStrings/worksheets	定位坏部件	坏件 styles + 坏件 sst + 好件全部 sheets → 可打开	定位到 worksheets
5	leave-one-out	19 个 sheet 逐个换成坏件版	找出坏 sheet	仅 sheet9《公交》/ sheet12《轨道、轮渡》失败	定位到 2 页
6	负向：非法格计数	修复前导出件	—	19 个 `t="n"` 带 `<is>`	命中根因
7	正向：修复后 2026-07	重启后端后导出	可打开、19 页、累计对	OK sheets=19；`DX5=144979.2825`（`=SUM(DK5:DV5)`）、`DY5=-0.101235487797891`、`EM5=161309.53162`、`CU5=173045.296428512`	通过
8	正向：修复后 2026-08	同上	可打开、累计不变	OK sheets=19；`DZ5=144979.2825`、`EO5=161309.53162`、`CW5=173045.296428512`、`S5=130311.892698249`	通过
9	跨月一致性	7 月 vs 8 月同口径格子	完全相等	2022 累计 / 2021 累计 / 2023 累计三个月度 → 三个值完全相等	通过
10	非法格复扫	修复后 7 月导出	0 个	0 个	通过
11	母版可打开	补齐后用 Excel 打开 7 月母版	可打开	可打开	通过
12	残留数据复核	`2026-09` 五张表计数	全 0	全 0（h204 / investment_monthly / h2032 / audit_result / import_batch）	通过

六、发现的问题与处置

7 月导出件打不开（P0）：normalizeStaleInlineStrings 根治；导出件从 941,960 字节（坏）→ 1,310,693 字节（好）。
备份母版回填让补齐失效（P0）：skipFreightHistoryBlocks 保护 货运 T 列及以后。
Excel COM 会留孤儿进程：每例测完必须强杀本次新建的 EXCEL 进程，否则后续 Workbooks.Open 会**间歇性假报**同样的错（本次排查初期被此干扰过）。属排查工具坑，已记入问题汇总。
注意：本次**未**改动 8 月母版与任何入库数据。

七、结论

2026-07 / 2026-08 两个导出件均可被 Excel 正常打开（各 19 页），且《货运》页 2021/2022/2023 累计列口径**完全一致**。
7 月母版已按 8 月母版口径补齐（年度块 360 格 + 累计 324 格），并从 openpyxl 血缘转为 Excel 原生。
用户要求的「残留数据全部清除」经复核为 0 残留。

八、遗留

2026-06 / 2026-09 无母版 → 预览返回 ready=False「未找到模板文件」，需新建母版才能出数（用户第 5 问的延伸）。
仓库根目录 _*.* 临时排查文件（含本次 _hyb_* / _loo_* / _v2_* / _final_*）未删，待用户同意。