报表中心改版后,采购月报出现四个数字:页面显示 1600 元,点击明细是 1800 元,导出文件合计 2700 元,已经封存的月结报表仍是 1600 元。把所有出口强行改成 1800 元看似"统一",却会掩盖真正的问题:页面还在读旧批次,导出漏了租户过滤,而月结的 1600 元是有意冻结的历史结果。
上线对账的目的不是让每个页面永远显示同一个数字,而是证明:同一指标版本、同一权限范围、同一业务时间窗和同一来源版本下,汇总、明细与导出能回到同一批单据。历史结算若采用冻结口径,则应有明确的差异和调整说明。本文用六条虚构采购记录建立一份可运行的验收样本,给出排查顺序、Java 断言、MySQL 对账 SQL 与上线门槛。
适用环境:Java 11、MySQL 8.x。金额在程序中用"分"整数计算,避免浮点误差。示例仅验证规则与差异定位;大数据量、并发和数据仓库同步性能还需在各自环境测量。
目录
- 先把"应该相等"的条件写全
- 用六条单据建立可解释的基准
- 四个出口为何给出三个不同数字
- 差异定位先比单据集合,再比金额
- [Java 断言怎样覆盖正常值和故障值](#Java 断言怎样覆盖正常值和故障值)
- 权限抽检与历史月结怎样分别验
- 从测试库到生产灰度的上线清单
- 小结与参考资料
一、先把"应该相等"的条件写全
运营同事说"这两个报表数字不一样",不能马上判定哪一个错。先记录一个可复核的对账键:metric_code 与 metric_version、租户和可见部门、业务时间窗及其时区、来源批次或数据截止、结果出口。对本例,指标是"审批确认后的采购金额 v1",只算 APPROVED,按 approved_at 归属 2026 年 11 月,区间为 [11 月 1 日, 12 月 1 日)。甲公司管理员能看 D10 与 D20;D10 员工只能看 D10。
若页面是 R1 批次、明细是 R2 批次,即使查询文字都叫"11 月已审批采购额",也不能拿两个数字直接相减认定计算有错。先对齐批次,再对齐权限范围。反过来,若页面、明细与导出声称使用同一批次和范围却仍不一致,那就是要阻止上线的缺陷。
历史月结另有约束。已确认并封存的 C1 月结不应因为后来到达一张单据就静默改写;差额可以进入补差或调整记录。这里假设 C1 在 R1 时冻结,后来 R2 多了 200 元。C1=1600 与 R2=1800 可以同时正确,但必须能指出具体哪张单据、为何属于 11 月、为何未进入旧月结。

图1:只有指标版本、授权范围、业务月份与来源版本一致,页面、钻取和导出才应直接相等。
二、用六条单据建立可解释的基准
样本仍是虚构采购单,但这次特意加入迟到、驳回、跨月和跨租户记录,以便每一种错误都能落到单号。posted_at 表示记录进入报表来源的时间;approved_at 决定业务月份。R1 的来源截止为 2026-11-03 00:00,R2 为 2026-11-04 00:00,都是左闭右开的上界。
| 单号 | 租户 / 部门 | 状态 | 审批日 | 进入来源 | 金额 | 11 月 R2 甲公司全量 |
|---|---|---|---|---|---|---|
| A100 | 甲 / D10 | 已审批 | 11-01 | 11-01 10:00 | 1000 | 计入 |
| A101 | 甲 / D20 | 已审批 | 11-02 | 11-02 11:00 | 600 | 计入 |
| A102 | 甲 / D10 | 已驳回 | 11-02 | 11-02 13:00 | 300 | 排除:状态 |
| A103 | 甲 / D10 | 已审批 | 11-01 | 11-03 09:00 | 200 | 计入:R2 才到达 |
| A104 | 甲 / D10 | 已审批 | 10-31 | 11-01 00:01 | 400 | 排除:业务月份 |
| B100 | 乙 / D10 | 已审批 | 11-01 | 11-01 14:00 | 900 | 排除:租户 |
手工可得:甲公司全量 R1 为 A100+A101=1600;R2 为 A100+A101+A103=1800;D10 员工在 R2 只能看到 A100+A103=1200。C1 在 R1 冻结,因此是 1600;与 R2 的 200 差额由 A103 解释。若导出错误地省略租户条件,B100 被加进来,得到 2700。
这份样本的价值在于:发现 2700 时不必凭经验猜"可能多了一张单";能直接列出多出的 B100。但六条记录不能代表真实数据量,也不负责证明查询性能。
MySQL 测试库可用下面的结构与数据复现;业务系统不需要照搬表名。月结明细单独存下冻结值,是为了表示旧结果有证据,而不是每次用当前事实重新计算"历史月结"。
sql
CREATE TABLE report_fact (
id VARCHAR(20) PRIMARY KEY,
tenant_id VARCHAR(20) NOT NULL,
department_id VARCHAR(20) NOT NULL,
status VARCHAR(20) NOT NULL,
approved_at DATETIME NOT NULL,
posted_at DATETIME NOT NULL,
amount_cents BIGINT NOT NULL,
KEY ix_report_scope (tenant_id, status, approved_at, department_id)
);
INSERT INTO report_fact VALUES
('A100','A','D10','APPROVED','2026-11-01 10:00:00','2026-11-01 10:00:00',100000),
('A101','A','D20','APPROVED','2026-11-02 11:00:00','2026-11-02 11:00:00', 60000),
('A102','A','D10','REJECTED','2026-11-02 13:00:00','2026-11-02 13:00:00', 30000),
('A103','A','D10','APPROVED','2026-11-01 18:00:00','2026-11-03 09:00:00', 20000),
('A104','A','D10','APPROVED','2026-10-31 23:59:00','2026-11-01 00:01:00', 40000),
('B100','B','D10','APPROVED','2026-11-01 14:00:00','2026-11-01 14:00:00', 90000);
CREATE TABLE report_close_item (
close_id VARCHAR(20) NOT NULL,
order_id VARCHAR(20) NOT NULL,
amount_cents BIGINT NOT NULL,
PRIMARY KEY (close_id, order_id)
);
INSERT INTO report_close_item VALUES
('C1','A100',100000), ('C1','A101',60000);
posted_at < R2 在这组只追加 的教学数据里足以模拟来源截止;真实表若允许修改旧金额、撤销审批或回写时间,单靠 posted_at 不等于不可变快照。应使用来源版本、冻结表或可追溯的变更记录固定验收对象。MySQL 的一致性读说明解释了同一事务如何读到一个快照,但不能把长时间持有事务当成异步报表的通用历史版本方案。
三、四个出口为何给出三个不同数字
把四个出口的实际读取条件摆到一起,差异就可解释:
| 出口 | 实际读取 | 看到的结果 | 判断 |
|---|---|---|---|
| 页面卡片 | 甲公司全量,R1 缓存 | 2 单,1600 | 页面批次落后,需要切到 R2 或显示截止时间 |
| 钻取明细 | 甲公司全量,R2 | 3 单,1800 | 本次验收基准 |
| 导出文件 | R2,但漏了租户条件 | 4 单,2700 | 越权,必须阻止发布和下载 |
| 冻结月结 C1 | R1 时确认的历史快照 | 2 单,1600 | 保留旧值,以 A103 解释差额 200 |
页面与月结恰好同为 1600,原因却完全不同。页面是未刷新或缓存键漏了批次;修复后应显示 R2=1800,或明确标注 R1 的截止。月结是历史结算事实,不能为了和当前页面一致而改掉。导出多出的 900 则来自乙公司的 B100,是权限缺陷,不能用"报表有延迟"解释。
上线前应要求所有出口返回或关联一份可检查的元数据:指标版本、授权范围标识、时间窗、来源批次、行数和文件哈希。缓存键要覆盖这些维度;异步导出任务要记录执行时使用的范围与数据版本。用户界面无需展示所有技术字段,但后台排障必须查得到。如果页面没有批次,工程师只知道 1600 和 1800,却无法判断谁旧谁错。

图2:页面与历史月结都为 1600,却分别属于"旧批次"与"冻结结果";2700 是导出混入 B100 的权限事故。
四、差异定位先比单据集合,再比金额
排查顺序可以固定为三层。第一层比元数据:指标版本、状态口径、业务时间窗、时区、租户与部门范围、数据截止或来源批次。任何一项不同,先弄清是否本来就允许不同。第二层比明细单号集合:哪些 ID 只在一边,哪些同时存在;第三层再比较同一 ID 的状态、归属日期、金额、部门和更新时间。这样能把"差 200"拆成"多了 A103",把"差 900"拆成"多了 B100"。
先跑同一 R2 条件下的全量与 D10 基准查询。金额用分保存,在 SQL 中先求和,再按需要格式化为元。
sql
SELECT COUNT(*) AS row_count, COALESCE(SUM(amount_cents),0) AS total_cents
FROM report_fact
WHERE tenant_id = 'A' AND status = 'APPROVED'
AND approved_at >= '2026-11-01' AND approved_at < '2026-12-01'
AND posted_at < '2026-11-04 00:00:00';
-- R2 甲公司全量:3 单,180000 分
SELECT id, department_id, amount_cents
FROM report_fact
WHERE tenant_id = 'A' AND department_id = 'D10'
AND status = 'APPROVED'
AND approved_at >= '2026-11-01' AND approved_at < '2026-12-01'
AND posted_at < '2026-11-04 00:00:00'
ORDER BY id;
-- D10:A100=100000 分,A103=20000 分;共 120000 分
SELECT COUNT(*) AS row_count, COALESCE(SUM(amount_cents),0) AS total_cents
FROM report_close_item WHERE close_id = 'C1';
-- C1:2 单,160000 分
为了排查错误导出,可把测试文件 解析后的单号写入临时验收清单,再与正确查询范围做集合差。下面的 report_export_manifest 是验收样本表,不是建议把所有生产导出内容永久复制一遍。
sql
CREATE TABLE report_export_manifest (
export_id VARCHAR(20) NOT NULL,
order_id VARCHAR(20) NOT NULL,
PRIMARY KEY (export_id, order_id)
);
INSERT INTO report_export_manifest VALUES
('E_BAD','A100'), ('E_BAD','A101'), ('E_BAD','A103'), ('E_BAD','B100');
SELECT m.order_id AS extra_in_export
FROM report_export_manifest m
LEFT JOIN report_fact f
ON f.id = m.order_id
AND f.tenant_id = 'A' AND f.status = 'APPROVED'
AND f.approved_at >= '2026-11-01' AND f.approved_at < '2026-12-01'
AND f.posted_at < '2026-11-04 00:00:00'
WHERE m.export_id = 'E_BAD' AND f.id IS NULL;
-- 预期只返回 B100;应阻止该文件交付
SELECT f.id AS added_after_close, f.amount_cents
FROM report_fact f
LEFT JOIN report_close_item c ON c.close_id = 'C1' AND c.order_id = f.id
WHERE f.tenant_id = 'A' AND f.status = 'APPROVED'
AND f.approved_at >= '2026-11-01' AND f.approved_at < '2026-12-01'
AND f.posted_at < '2026-11-04 00:00:00'
AND c.order_id IS NULL;
-- 预期只返回 A103,20000 分
只有总额相等也不够。两张单据一增一减,金额可以抵消;导出若漏掉 A100 又错误加入另一张同额单据,总额仍可能是 1800。因此上线门槛应同时检查行数、单号集合和金额,必要时按部门、日期、状态再分组核对。生产数据可能包含更正记录或一个业务单号多条版本,集合键应选真正唯一的业务事实键和版本,不要照搬本例的简单单号。

图3:R2 与月结差 200 由迟到的 A103 解释;错误导出比 R2 多 900 则来自跨租户的 B100。
五、Java 断言怎样覆盖正常值和故障值
下面的 Java 11 文件不依赖框架,执行后验证八项条件:R1、R2、D10 范围、错误导出的单号与金额、迟到差额、批次差异和租户分离。它把错误导出的过滤条件写成一个单独方法,目的是让读者看到如何证明缺了租户条件;不能把这个方法接进真实导出服务。
bash
javac tools/Stage12ReportReconciliationExample.java
java -cp tools Stage12ReportReconciliationExample
java
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.util.ArrayList;
import java.util.Comparator;
import java.util.List;
import java.util.Set;
import java.util.stream.Collectors;
/** JDK 11 teaching fixture for report release reconciliation. */
public class Stage12ReportReconciliationExample {
static final LocalDateTime R1 = LocalDateTime.parse("2026-11-03T00:00:00");
static final LocalDateTime R2 = LocalDateTime.parse("2026-11-04T00:00:00");
static final LocalDate FROM = LocalDate.parse("2026-11-01");
static final LocalDate TO = LocalDate.parse("2026-12-01");
static final class Fact {
final String id, tenant, department, status;
final LocalDate approved;
final LocalDateTime posted;
final long cents;
Fact(String id, String tenant, String department, String status,
String approved, String posted, long cents) {
this.id = id; this.tenant = tenant; this.department = department;
this.status = status; this.approved = LocalDate.parse(approved);
this.posted = LocalDateTime.parse(posted); this.cents = cents;
}
}
static final List<Fact> FACTS = List.of(
new Fact("A100", "A", "D10", "APPROVED", "2026-11-01", "2026-11-01T10:00:00", 100000),
new Fact("A101", "A", "D20", "APPROVED", "2026-11-02", "2026-11-02T11:00:00", 60000),
new Fact("A102", "A", "D10", "REJECTED", "2026-11-02", "2026-11-02T13:00:00", 30000),
new Fact("A103", "A", "D10", "APPROVED", "2026-11-01", "2026-11-03T09:00:00", 20000),
new Fact("A104", "A", "D10", "APPROVED", "2026-10-31", "2026-11-01T00:01:00", 40000),
new Fact("B100", "B", "D10", "APPROVED", "2026-11-01", "2026-11-01T14:00:00", 90000)
);
static List<Fact> eligible(String tenant, Set<String> departments,
LocalDateTime sourceCutoff) {
return FACTS.stream().filter(f -> f.tenant.equals(tenant)
&& departments.contains(f.department)
&& f.status.equals("APPROVED")
&& !f.approved.isBefore(FROM) && f.approved.isBefore(TO)
&& f.posted.isBefore(sourceCutoff))
.sorted(Comparator.comparing(f -> f.id)).collect(Collectors.toList());
}
static List<Fact> faultyExportWithoutTenant(Set<String> departments,
LocalDateTime sourceCutoff) {
return FACTS.stream().filter(f -> departments.contains(f.department)
&& f.status.equals("APPROVED")
&& !f.approved.isBefore(FROM) && f.approved.isBefore(TO)
&& f.posted.isBefore(sourceCutoff))
.sorted(Comparator.comparing(f -> f.id)).collect(Collectors.toList());
}
static long total(List<Fact> rows) {
return rows.stream().mapToLong(f -> f.cents).sum();
}
static String ids(List<Fact> rows) {
return rows.stream().map(f -> f.id).collect(Collectors.joining(","));
}
static String money(long cents) {
return String.format("%d.%02d", cents / 100, cents % 100);
}
static void check(boolean ok, String label) {
if (!ok) throw new AssertionError(label);
}
public static void main(String[] args) {
Set<String> company = Set.of("D10", "D20");
List<Fact> r1 = eligible("A", company, R1);
List<Fact> r2 = eligible("A", company, R2);
List<Fact> d10 = eligible("A", Set.of("D10"), R2);
List<Fact> brokenExport = faultyExportWithoutTenant(company, R2);
List<Fact> late = new ArrayList<>(r2);
late.removeAll(r1); // Same fixture objects; identifies rows added to R2.
check(ids(r1).equals("A100,A101") && total(r1) == 160000, "R1");
check(ids(r2).equals("A100,A101,A103") && total(r2) == 180000, "R2");
check(ids(d10).equals("A100,A103") && total(d10) == 120000, "D10 scope");
check(ids(brokenExport).equals("A100,A101,A103,B100"), "leak fixture");
check(total(brokenExport) == 270000, "leak amount");
check(ids(late).equals("A103") && total(late) == 20000, "late arrival");
check(total(r1) != total(r2), "old batch should differ");
check(eligible("B", Set.of("D10"), R2).size() == 1, "tenant separation");
System.out.println("R2 baseline for page/detail/export: 3 rows, " + money(total(r2)));
System.out.println("old page and frozen close C1: 2 rows, " + money(total(r1)));
System.out.println("broken export without tenant: 4 rows, " + money(total(brokenExport)));
System.out.println("D10 scope: 2 rows, " + money(total(d10)));
System.out.println("R2 - C1: A103, " + money(total(late)) + "; 8 checks passed");
}
}
预期输出:
text
R2 baseline for page/detail/export: 3 rows, 1800.00
old page and frozen close C1: 2 rows, 1600.00
broken export without tenant: 4 rows, 2700.00
D10 scope: 2 rows, 1200.00
R2 - C1: A103, 200.00; 8 checks passed
这组断言是最小回归集,不是完整系统测试。接口层还要分别访问页面、钻取、导出提交、文件下载,比较每个出口实际使用的指标版本与范围,而非只调用同一个 eligible 方法四次。否则测试可能证明了公共函数正确,却没有发现某个控制器绕过它。
六、权限抽检与历史月结怎样分别验
权限抽检要覆盖"谁、对什么数据、通过哪个出口、做什么操作"。甲公司管理员可看 D10+D20 的 R2 三单;D10 员工只能看 A100+A103;乙公司用户不能通过修改请求参数拿甲公司任务 ID;已经撤销 D10 权限的用户不能沿旧下载链接获取文件。页面隐藏按钮不算通过,必须以接口和真实文件内容为准。OWASP 的授权测试指南建议把角色、功能和数据范围做成可自动执行的矩阵,避免功能新增后漏测出口。
| 身份与范围 | 页面 / 明细 | 导出任务 | 下载旧文件 | 预期 |
|---|---|---|---|---|
| 甲公司管理员,D10+D20 | 3 单,1800 | 仅 A100/A101/A103 | 仍有权限时可取 | 允许 |
| 甲公司 D10 员工 | 2 单,1200 | 仅 A100/A103 | 仅本人的 D10 文件 | 允许本范围 |
| 乙公司用户 | 不可见甲公司单据 | 不能提交甲公司范围 | 不能取甲公司文件 | 拒绝 |
| 甲公司已撤权用户 | 当前范围不可见 | 不再生成 | 已生成文件也不可取 | 拒绝 |
月结的验收是另一条线。C1 在 R1 确认时只有 A100+A101,1600 元;R2 的 A103 审批日是 11 月 1 日,却在 11 月 3 日才进入来源。应记录"迟到单 A103,归属 11 月,金额 200 元,未纳入 C1",按财务制度决定补记、调整或下期处理。本文不替业务制定会计规则。系统至少不能直接覆盖 C1 的原值,否则审计时无法重建当时为什么是 1600。
若历史结果与新口径不一致,还要先确认是否发生了指标版本升级。v1 与 v2 即使同名也应分别对账;需要重算历史时,生成新的重算批次与差异清单,保留旧批供追溯。把"新定义值"直接写回旧结算行,会让指标变更与数据修正无法区分。

图4:小样本验证规则及越权路径;历史月结只对比差异并保留冻结证据,不要求静默变成当前值。
七、从测试库到生产灰度的上线清单
先在测试库用六条样本跑完 SQL 与 Java 断言;然后抽取代表性的历史月份、不同大小租户、不同部门层级与迟到数据,在新旧链路间做影子对账。每次差异都存下:指标版本、来源批次、授权范围、查询时间窗、页面值、明细 ID 集合、导出文件哈希、差异单号与处理结论。敏感明细不宜直接写进普通运行日志,日志可记录任务 ID、摘要和受控的排障位置。
上线门槛建议按严重程度处理:跨租户、跨部门泄露,或同批次同范围下页面与文件的未解释差异,应阻止发布;缓存尚未切换导致短时旧值,只有在页面明确显示来源截止、产品允许延迟且下载仍安全时才可按既定策略放行;已冻结月结与新批次有差异,若每笔调整可解释,可以保留两者并给出差异清单。具体时延与抽样规模应由本系统的数据量和业务要求制定,不能照抄本文六条样本。
生产切换可先让新链路只计算、不对外展示。确认多个批次连续通过后,再小范围启用,并保留旧批与回退开关。切换后持续观察差异数量、未解释差异、迟到单补算、权限拒绝和导出文件一致性;若出现 B100 这类越权单据,先停用错误出口和撤销受影响文件访问,再修复过滤并重新验收。不要通过人工改总额让报表"看起来一致"。

图5:单据集合、金额、权限矩阵、来源批次和回退路径同时通过,才构成可复核的上线验收。
八、小结与参考资料
报表对账最有效的顺序是:先对齐口径与数据版本,再对齐授权范围,随后比单号集合和金额,最后把每一笔差异归到迟到、状态变化、权限过滤、缓存或历史冻结。本文的 1600、1800、2700 不是三个可以随意选的答案:旧页面要刷新,越权导出要拦截,冻结月结要保留并解释 200 元差额。这样上线后遇到不同数字,团队能说清"为什么不同、谁该修、怎样证明已经修好"。
参考资料: