功能测试报告：货运量/周转量 2023 年数据补录入库

日期：2026-09-16
模块：数据导入 / 货运量周转量
结论：**通过**（正向 1 条、入库抽查 216 项全对齐、上年同期 1 条、幂等/回归 2 条）

一、功能说明

用户反馈「2023 年有 12 月的数据」，而上轮入库使用的 8 月源文件**缺 2023 年 Sheet**（只有 2026年/2025年/2024年/2022年/2021年），因此库里没有 2023-12。

排查后在 7 月源文件中找到 2023 年数据，将其补录入库：
| 项 | 内容 |
|----|------|
| 数据来源 | D:\05_数据分类\货运\7月\定稿-湖北省各市州运输量数据（2026年1-7月）.xlsx 的 2023 Sheet |
| 补录方式 | 另存临时工作簿 _2023_import_tmp.xlsx（仅保留 2023 + 2022年 两个 Sheet，满足多年度工作簿「至少 2 个 Sheet」规则），走 POST /api/import/freightTurnover?period=2023-12 |
| 结果 | 货运量周转量导入成功, 共 36 条记录（18 地市 × 2 个报表期：2022-12 重写 + 2023-12 新增） |

为什么带上 2022 年 Sheet：2023 的上年同期取自「上一年度 Sheet」，只放 2023 会导致 2023 的 last_* 为空；同时避免整本导入 7 月文件而多出无用的 2026-07 报表期。

二、测试环境

后端：重启后新编译，Tomcat started on port(s): 8090，PID 31384
数据库：traffic_audit.freight_turnover_import
源文件：7 月文件 2023 Sheet（A1:N48：货运量(万吨) 块 + 周转量(万吨公里) 块，1–12 月 + 累计列）

三、用例表

#	场景	输入	预期	实际	结论
1	正向-2023 入库	`_2023_import_tmp.xlsx` → freightTurnover	生成 `2023-12`，18 行	`共 36 条记录`；`SELECT report_period,COUNT(*)` 出现 `2023-12 = 18`	通过
2	入库抽查-逐格比对	2023 Sheet 货运量块 + 周转量块（18 地市 × 12 月 × 2 指标 = 432 项）	与库中 `freight_m01..m12` / `turnover_m01..m12` 完全一致	mismatches = 0（18 个地区全部匹配）	通过
3	上年同期	查 2023-12 的 `last_freight_` / `last_turnover_`	等于 2022 年同月值	武汉 `last_freight_m01=3527.89407360113`、`last_freight_m12=4334.42636773157`、`last_turnover_m12=608823.495390257`，与 `2022-12` 行逐值相同	通过
4	报表期清单回归	查全部报表期	无重复、无 2099 残留	2021-12 / 2022-12 / 2023-12 / 2024-12 / 2025-12 / 2026-01…2026-08，每期 18 行	通过
5	历史期未被污染	2022-12 重写后与原值比较	完全一致	与改动前 2022-12 逐值相同	通过

四、发现的问题与处置

#	问题	处置
1	8 月源文件无 2023 年 Sheet，导致库里长期缺 `2023-12`、且 `2024-12` 无上年同期	从 7 月源文件补录 `2023-12`；`2024-12` 的上年同期本次未重算（需重导 2024 才会生效），如需可另行补导
2	7 月文件与 8 月文件的 2021/2022/2024 三年数据是否一致无法确定	逐格比对：`onlyJuly/onlyAug/differ` 全部为空，三年 0 处差异，因此补导 2022 不会引入偏差
3	若整本导入 7 月文件会多出 `2026-07` 报表期	改为只保留 `2023 + 2022年` 两个 Sheet 的临时工作簿，避免产生无用期次
4	单 Sheet 文件不会被识别为多年度工作簿	已在本报告与《问题与注意事项汇总》中记录该规则，供后续补数参考

五、结论

2023 年货运量/周转量已完整入库（18 地市 × 12 月），**432 项逐格比对零差异**，上年同期正确取自 2022 年。
报表期清单连贯：2021-12 → 2026-08 共 13 期，每期 18 行。
遗留：2024-12 的上年同期（2023 年值）未回填，如需要可重导 2024 年数据。