# 功能测试报告_货运页签累计列核对与 9/16 导入数据体检_2026-09-16

## 一、功能/任务说明
针对两个业务问题做核对：
1. 9/16 新导入的「道路客运（H2031/个体户）」与「道路货运（H2032/货运量周转量）」数据是否存在错误；
2. 汇总大表「 货运」页签的「累计」列，为什么只有前几个能和人工核算对上。

## 二、测试环境
- 后端：Spring Boot 8090（`/api/report/export/summaryWorkbook`）、MySQL 127.0.0.1:3308/traffic_audit
- 导出件：`_fresh_summary_2026-08.xlsx`（period=2026-08&mode=month，SHA 尺寸 950,186 字节）
- 参照件：
  - `D:\05_数据分类\高速\定稿-湖北省各市州运输量数据（2026年1-8月）.xlsx`（含 2026年/2025年/2024年/2022年/2021年 页，**无 2023 页**）
  - `D:\05_数据分类\货运\7月\定稿-湖北省各市州运输量数据（2026年1-7月）.xlsx`（含 2023 页）
  - `D:\05_数据分类\汇总表\8月汇总定稿\2026年8月客运量、货运量定稿.xlsx`
- 母版：`docs/生成汇总大表/生成_道路运输量汇总表.xlsx`（Sheet「 货运」）
- 方法：先按语义键（地区+指标+列标题）对齐，再逐格比对；导出端公式用本地求值器 `_hy*.py` 还原（openpyxl data_only 读不到公式缓存）。

## 三、结论一：汇总表「 货运」页签 6 个「累计」列核对

页签中共有 6 个累计列，分别为 S(2026 年 1-8 月)、AT(2025 年)、BV(2024 年)、CW(2023 年)、DZ(2022 年)、EO(2021 年)。
以全省行「货运量」为例（单位：万吨）：

| 年度 | 列 | 汇总表显示 | 源文件核算值 | 差异 | 结论 |
|---|---|---|---|---|---|
| 2026(1-8月) | S | 130311.8927 | 130311.8927 | 0.0000 | 一致 |
| 2025 | AT | 195433.2232 | 195433.2232 | 0.0000 | 一致 |
| 2024 | BV | 184938.5780 | 184938.5780 | 0.0000 | 一致 |
| 2023 | CW | 173045.2932 | 173045.2964 | **-0.0033** | 不一致 |
| 2022 | DZ | 144979.2854 | 144979.2825 | **+0.0029** | 不一致 |
| 2021 | EO | **空** | 161309.5316 | **-161309.5316** | **整列缺失** |

「货物周转量」行结论相同：2026/2025/2024 一致，2023 差 -0.0017、2022 差 +0.0025、2021 整列为空。
市州行（17 市州）2026/2025/2024/2023/2022 与库内数据逐格一致，差异只出现在「全省」行与 2021 列。

### 原因（已定位到母版）
1. **2021 年列（EO）在母版里根本没有值**：`生成_道路运输量汇总表.xlsx` 的 ` 货运` 页 `EO5` = 空、`EP5`（累计同比）= 空，而 `EC5:EN5`（2021 年 1-12 月）都有值，合计 161309.5316。即**母版漏填了 2021 年的累计公式**。8 月定稿同样为空（`EP` 为空），说明是历史遗留、非本次导出造成。
2. **2022 年列（DZ）在母版里是写死的常量**：`DZ5 = 144979.285376043`（类型是数值，不是公式），`EA5`（累计同比）= -0.101235470414284 也是常量。它等于母版自身 2022 年各月值之和，但与现源文件 `2022年` 页湖北省行（144979.2825）差 0.0029 —— 母版 2022 年各月是当年手工录入的旧精度数据（如 1 月 10709.5265 vs 源文件 10709.5234），**不会再随数据刷新**。
3. **2023 年列（CW）虽是公式，但输入来自母版**：母版 2023 年全省行是「规上+规下」两行相加，精度与源文件 `2023` 页湖北省行不同，合计差 0.0033（全省行）。市州行一致。
4. 2026/2025/2024 三年之所以能对上，是因为母版这三块的各月值与现源文件完全一致（逐格 0 差异）；且代码 `SummaryWorkbookFiller.fillFreightSheet` 每次导出只回填“目标当月”一列，历史月份一律沿用母版，所以母版对不上就整体对不上。

### 修复建议（待确认后执行）
- 母版 ` 货运` 页 EO 列按同构公式补齐：`EO5 = EC5+EE5+EG5+EI5+EK5+EM5+EO5`… 实际应为 12 个月列（EC/ED/…/EN）之和；EP 补累计同比。
- DZ 列改为公式（DM+DN+…+DX 之和），使其随数据刷新，避免继续沿用 2 位数前的旧值。
- 2023/2022 的 0.003 级差异属母版历史录入精度问题，如需与源文件完全对齐，需按源文件重填这两个年度块。

## 四、结论二：9/16 新导入数据体检

### 4.1 本次导入清单（import_batch）

| 类型 | 期次 | 行数 | 来源文件 |
|---|---|---|---|
| FREIGHT_TURNOVER | 2021-12 / 2022-12 / 2023-12 / 2024-12 / 2025-12 / 2026-07 / 2026-08 | 各 18 | 定稿-湖北省各市州运输量数据（2026年1-8月 / 1-7月）.xlsx |
| H2031（公路旅客） | 2025-02 ~ 2025-12（11 期） | 814/809/798/795/791/806/800/796/796/798/792 | 公路旅客运输月度生产情况（2025）*.xls |
| PASSENGER_AUTH | 2025-02 ~ 2025-12 | **0** | 同上 |
| PASSENGER_INDIVIDUAL | 2025-01 ~ 2025-12 | 各 7 | 湖北省公路旅客运输个体户月度生产情况（2025.*）.xlsx |
| H2032（道路货运） | 2025-04 | 664 | 道路货物运输月度生产情况（2025年4月）.xls |

### 4.2 发现的问题

| # | 严重度 | 问题 | 证据 | 影响 |
|---|---|---|---|---|
| 1 | 高 | `h2032_enterprise_monthly` 多出一个 **2026-09 期**，其源文件名却是「道路货物运输月度生产情况（2026年8月）.xls」（2026-09-10 导入，batch id 302） | 与 2026-08 期逐企业比对：同为 636 条、90 个区划、**企业集合完全相同**，仅 38 家企业数值不同；全省合计 08=3665.3638 / 09=3690.5636 | 8 月报表不受影响（累计只取 1-8 月），但生成 9 月报表时会把这份「8 月副本」当成 9 月数据 |
| 2 | 高 | `h2031_enterprise_monthly` **缺 2025-01** | 2025 年只有 2025-02~2025-12 共 11 期；`import_batch` 无 2025-01 的 H2031 记录 | 公路旅客 2025 年累计少 1 个月；「与去年同比」整体偏移 |
| 3 | 中 | `passenger_individual_monthly` 2026-08 **缺黄冈市**（只有 6 条，其余月份 7 条） | 2026-07 有 黄冈/黄石/荆门/随州/襄阳/孝感×2；2026-08 无黄冈 | 2026-08 班线包车/公路总客运的「其中个体」少黄冈一家 |
| 4 | 低 | PASSENGER_AUTH 每期 0 行 | 11 个批次 success_rows 均为 0 | 暂无影响（该台账本期无授权数据），但需确认是否应有数据 |
| 5 | 提示 | 2025-04 的 H2032 此前缺失，本次已补齐 | batch id 382，664 行全成功 | 已修复 |
| 6 | 提示 | h2032 区划集合年度间有变动 | 2025-12 有 87 个区划、2026-08 有 90 个；2026 新增 420822/420921/420922/420982，2025 独有 420161 | 属企业进退规的正常变动，仅提示 |

### 4.3 入库抽查（与源文件逐项对齐）
- H2032 2025 全年规上货运量 = 50117.0940 万吨、规上周转量 = 7435040.9971 万吨公里 → 与汇总表 2025 累计列 **完全一致**。
- H2032 2026 年 1-8 月规上货运量 = 31399.8248 万吨（逐市州：武汉 10072.9811、黄石 1141.0468、十堰 97.1046、宜昌 5925.3101、襄阳 2528.7835、鄂州 861.4684、荆门 632.9213、孝感 1384.5256、荆州 1278.1560、黄冈 5397.3567、咸宁 730.5726、随州 453.8854、恩施州 46.4794、仙桃 156.5243、潜江 304.9884、天门 347.0714、林区 40.6492）→ 与导出件「货运量排名」累计表 **17/17 全部一致**。
- FREIGHT_TURNOVER 2021~2026 各期合计与源文件各年度页求和一致（除上表 2021/2022/2023 三处差异）。
- 2026-09 期数据来自「2026年8月」文件，判定为**期次错误**，建议核实后删除或改期。

## 五、遗留问题
1. 母版 2021 累计列（EO/EP）缺失、2022 累计列为常量，是否授权修改需业务确认。
2. H2031 2025-01 补齐所需源文件待用户提供。
3. h2032 的 2026-09 脏期处置方式待确认（删除 or 保留改名）。

## 六、结论
- 「累计只有前几个对得上」的直接原因是**母版里 2021 累计列为空、2022 累计列为写死常量，2023 累计列输入精度与源文件不符**；2026/2025/2024 三年与源文件完全一致。
- 本次导入的「道路货运」存在 1 处期次错误（2026-09 实为 8 月数据副本）；「道路客运」存在 2025-01 缺月、2026-08 个体户缺黄冈两处缺口。