E3-02清算文件1 分钟更新于 2026-11
文件格式
一句话
CSV、定长、XML 各有各的坑,不存在「万能解析器」——每个渠道一个解析器,是合理成本。
文件格式
四种格式的坑
stack四种清算文件格式
CSV / 分隔符
字段里带逗号、引号转义、BOM 头、空列
定长文本
按字节切;中文一个字三字节,按字符切会错位
XML
命名空间、层级深、同一含义多种写法
JSON 分页
分页边界、排序不稳定导致漏单
定长文件为什么最容易错
银行的老系统用定长:「前 20 字节是订单号,接下来 12 字节是金额」。 如果用字符数去切,一个中文姓名就会让后面全部错位。
正确做法:按字节读,按声明的编码解码。
解析器要可配置
同一家渠道的不同文件可能字段顺序不同。把「字段位置、类型、编码、单位」做成配置, 而不是硬编码在每个渠道的类里。
一个反例
某团队写了个「万能 CSV 解析器」,遇到字段里带逗号的账单直接错位,对账全乱。现在每个渠道一个解析器,配样本做回归。
常见误判
- 写一个「通用 CSV 解析器」处理所有渠道(边界情况无穷)
- 用字符长度切定长字段
- 忽略 BOM,导致第一个字段名带不可见字符
自查清单
- 每个渠道有独立解析器与测试样本吗
- 定长文件按字节切还是按字符切
- BOM 与编码处理了吗
- 分隔符冲突的字段有转义规则吗
- 解析失败会整份退回吗
依据
相关阅读