架构与系统设计 / 系统课时
对账数据标准化
对账数据标准化
本课把两种字段完全不同的渠道账单转换为统一交易记录,统一金额方向、交易状态、时间格式和幂等标识,使后续匹配逻辑只面向一种数据模型。
学习目标
- 定义能够承载支付与退款的统一对账记录
- 编写渠道适配器完成字段映射和状态归一
- 识别金额符号、时间格式、重复记录等关键边界
统一模型与转换规则
标准记录至少需要渠道、渠道流水号、商户订单号、交易方向、绝对金额、币种、交易时间和标准状态。支付与退款不要仅依赖金额正负号判断,应优先读取渠道交易类型,再把金额统一保存为绝对值。
| 标准字段 | 统一规则 |
|---|---|
direction |
归一为 PAYMENT 或 REFUND |
amount |
使用绝对值,禁止混用元和分 |
status |
归一为 SUCCESS、FAILED、PENDING |
tradeTime |
转为同一时区的时间类型 |
standardKey |
渠道、渠道流水号和方向组成稳定幂等键 |

标准化层只负责“翻译”,不要在这里查询本地订单或判断是否对账成功。字段转换与业务匹配分离后,新增渠道时只需增加适配器,不必修改核心匹配引擎。
主示例:适配两种账单格式
下面示例使用 Java 17 的 record 表示统一记录,并分别解析渠道 A 与渠道 B 的一行 CSV。为突出映射逻辑,示例假设字段中不包含逗号;生产环境应使用成熟 CSV 库处理引号、转义和空列。将代码保存为 BillNormalizer.java,使用 javac BillNormalizer.java && java BillNormalizer 运行。
import java.math.BigDecimal;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
public class BillNormalizer {
enum Direction { PAYMENT, REFUND }
enum Status { SUCCESS, FAILED, PENDING }
record StandardRecord(
String channel,
String channelTxnId,
String merchantOrderNo,
Direction direction,
BigDecimal amount,
String currency,
LocalDateTime tradeTime,
Status status,
String standardKey
) {}
public static void main(String[] args) {
String channelALine = "TX1001,ORDER9001,PAY,12.50,HKD,2026-08-03 10:15:30,S";
String channelBLine = "REFUND|RB2001|ORDER9001|-12.50|HKD|20260803102000|00";
System.out.println(normalizeChannelA(channelALine));
System.out.println(normalizeChannelB(channelBLine));
}
private static StandardRecord normalizeChannelA(String line) {
String[] value = line.split(",", -1);
Direction direction = "PAY".equals(value[2])
? Direction.PAYMENT : Direction.REFUND;
Status status = switch (value[6]) {
case "S" -> Status.SUCCESS;
case "F" -> Status.FAILED;
default -> Status.PENDING;
};
return build(
"CHANNEL_A", value[0], value[1], direction,
new BigDecimal(value[3]), value[4],
LocalDateTime.parse(value[5],
DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")),
status
);
}
private static StandardRecord normalizeChannelB(String line) {
String[] value = line.split("\\|", -1);
Direction direction = "REFUND".equals(value[0])
? Direction.REFUND : Direction.PAYMENT;
Status status = switch (value[6]) {
case "00" -> Status.SUCCESS;
case "99" -> Status.FAILED;
default -> Status.PENDING;
};
return build(
"CHANNEL_B", value[1], value[2], direction,
new BigDecimal(value[3]), value[4],
LocalDateTime.parse(value[5],
DateTimeFormatter.ofPattern("yyyyMMddHHmmss")),
status
);
}
private static StandardRecord build(
String channel,
String channelTxnId,
String merchantOrderNo,
Direction direction,
BigDecimal rawAmount,
String currency,
LocalDateTime tradeTime,
Status status
) {
BigDecimal amount = rawAmount.abs().setScale(2);
String standardKey = channel + "|" + channelTxnId + "|" + direction;
return new StandardRecord(
channel, channelTxnId, merchantOrderNo, direction,
amount, currency, tradeTime, status, standardKey
);
}
}预期输出
StandardRecord[channel=CHANNEL_A, channelTxnId=TX1001, merchantOrderNo=ORDER9001, direction=PAYMENT, amount=12.50, currency=HKD, tradeTime=2026-08-03T10:15:30, status=SUCCESS, standardKey=CHANNEL_A|TX1001|PAYMENT]
StandardRecord[channel=CHANNEL_B, channelTxnId=RB2001, merchantOrderNo=ORDER9001, direction=REFUND, amount=12.50, currency=HKD, tradeTime=2026-08-03T10:20, status=SUCCESS, standardKey=CHANNEL_B|RB2001|REFUND]示例中渠道 B 的退款金额为负数,但标准记录中的金额被转换为 12.50,退款含义由 direction=REFUND 明确表达,避免后续统计同时处理类型和符号。
数据质量与幂等边界
入库前应校验渠道流水号、币种、交易时间和金额是否为空或非法。金额精度必须按币种规则处理,不能默认所有币种都有两位小数;渠道账单若使用最小货币单位,还要先按明确倍率转换。
standardKey 应建立唯一约束。重复导入同一账单时,系统可以忽略完全相同的记录;若相同键对应的金额或状态不同,应记录版本冲突并进入异常队列,不能静默覆盖原数据。
时间标准化要明确账单时区。无时区字段的本地时间必须结合渠道配置解释,再转换为平台统一时区或 UTC;否则跨日交易会被归入错误账单日期。
验收方法
准备一条支付、一条退款和一条未知状态记录,确认转换后金额均为绝对值,方向分别正确,未知状态进入 PENDING。随后重复执行同一批数据,数据库中标准记录数量不应增加,且冲突记录能够被单独识别。