跳到正文
E3-02清算文件1 分钟更新于 2026-11

文件格式

一句话

CSV、定长、XML 各有各的坑,不存在「万能解析器」——每个渠道一个解析器,是合理成本。

本文目录7 节

文件格式

四种格式的坑

stack四种清算文件格式
CSV / 分隔符
字段里带逗号、引号转义、BOM 头、空列
定长文本
按字节切;中文一个字三字节,按字符切会错位
XML
命名空间、层级深、同一含义多种写法
JSON 分页
分页边界、排序不稳定导致漏单

定长文件为什么最容易错

银行的老系统用定长:「前 20 字节是订单号,接下来 12 字节是金额」。 如果用字符数去切,一个中文姓名就会让后面全部错位。

正确做法:按字节读,按声明的编码解码。

解析器要可配置

同一家渠道的不同文件可能字段顺序不同。把「字段位置、类型、编码、单位」做成配置, 而不是硬编码在每个渠道的类里。

一个反例

某团队写了个「万能 CSV 解析器」,遇到字段里带逗号的账单直接错位,对账全乱。现在每个渠道一个解析器,配样本做回归。

常见误判

  • 写一个「通用 CSV 解析器」处理所有渠道(边界情况无穷)
  • 用字符长度切定长字段
  • 忽略 BOM,导致第一个字段名带不可见字符

自查清单

  • 每个渠道有独立解析器与测试样本吗
  • 定长文件按字节切还是按字符切
  • BOM 与编码处理了吗
  • 分隔符冲突的字段有转义规则吗
  • 解析失败会整份退回吗

依据

相关阅读