讯果报表上新：XLSX 三表对账与失败归因

5.0.0 的导出菜单多了一个 XLSX 选项，导出的文件里放三张工作表：成功、失败、重试。三张表共用同一列记录编号，可以在表格软件里直接建立关联。此前用户拿到的是三个独立 CSV，字段能对上但行序不同，复核时要按编号手工排序，一个 4,200 条的批次大约要花 20 分钟，而这段时间几乎全是重复劳动。二十多分钟的排序与核对，换来的只是一张能看的总表，这显然不该是批量工具留给用户的工作。

这次改动看起来只是把三个文件装进一个文件，实际处理的是失败归因这个更麻烦的问题。失败表里不再只写一句错误信息，而是给出原因分类、原始响应码与建议动作。复核的人不需要懂协议细节，也能判断这一条是该重跑、该改清单，还是该放弃，判断依据直接写在表里，不必再翻文档查错误码。原始响应码保留在表里，是为了在需要联系支持时能直接给出可复现的线索。

三张表为什么按编号关联

记录编号在导入清单时生成，取自行号并加批次前缀，同一批次内唯一，跨批次可区分。这个编号从导入到导出一路不变，重试产生的新记录沿用原编号并在重试表里加一列重试次数，因此一条记录的所有尝试都能串起来。即使中途断电续跑过，编号也不会被重新编排，这一点是后续所有对账的前提。批次前缀取自导入时间，同一份清单重复导入两次会得到两个前缀，不会互相覆盖。

成功表包含记录编号、动作类型、完成时间、耗时与结果摘要；失败表包含记录编号、状态码、失败原因分类、原始响应与建议动作；重试表包含记录编号、重试次数、每次的耗时与最终状态。三张表的第一列都是记录编号，按它排序后可以一眼看出哪些记录只有失败没有成功、哪些重试后转成功，哪些重试后仍然失败。三张表的列序与列名固定，模板化的报表可以直接套用同一套透视表，不必每次重建。

如果只是想在表格里筛出失败条目，其实失败表单独看就够了。三表关联的价值出现在对账环节：财务关心的是这批里到底有多少条真的跑成功了，而失败与重试两张表都可能包含同一条记录。按编号关联后，用一张数据透视表就能算出唯一成功条数，不必手工去重，也不需要解释为什么总数比清单多。数据透视表的唯一成功条数，与客户端批次详情页显示的成功数一致，可以作为交叉校验。

9 个失败分类的划分依据

失败原因归入 9 个固定分类：网络超时、连接重置、目标限流、凭据失效、字段缺失、格式不符、余额不足、状态冲突与未知错误。前四类属于传输与访问层，中间三类属于数据层，状态冲突指目标对象已被其他流程改动，未知错误是无法归入前八类的兜底项，出现时建议连同原始响应一起保留。分类名称在界面与导出文件中完全一致，避免看界面时叫一个名字、看报表时又叫另一个。

分类的目的不是把错误说清楚，而是让处理动作唯一。网络超时、连接重置与目标限流建议换时段重跑；凭据失效需要更新凭据后重跑；字段缺失与格式不符必须先修清单；余额不足与状态冲突需要人工确认后再决定；未知错误建议保留原始响应并联系支持。同一类对应同一个动作，复核时不需要逐条判断。建议动作是对分类的补充说明，同样是固定文案，不随批次变化，便于团队统一处理口径。

研发负责人罗砚提到分类口径的取舍：「一开始想按协议分，分成十几个类别，后来发现用户看不懂也用不上。9 个分类是按看到之后该做什么倒推出来的，同一类对应同一个动作，这样失败表才不是一堆需要转发的截图。」分类同时会进入重试动作的筛选条件，重跑时可以只挑某一类，避免把数据问题也一起重跑。分类口径一旦确定就不再轻易调整，新增错误类型会先归入未知错误，再在下个版本里细分。

脱敏与二次确认

报表可能包含账号标识、卡号尾号与备注等敏感字段，因此导出前会弹出一次确认，说明当前选中的字段范围，并提供「脱敏导出」选项。脱敏会保留首尾各两位字符、中间以星号替代，同时保留记录编号，保证脱敏后仍能对账。这个处理只作用于导出文件，工作目录内的原始清单与回执不受影响。脱敏只处理值，不处理列名与编号，因此按编号关联、按分类筛选都不受影响。

默认勾选的是脱敏导出，取消勾选需要再确认一次。这个设计在内部有过争论，有人认为多一次点击很烦，但从实际使用看，报表多数用于复盘与交接，脱敏版足够用；确实需要完整数据的场景，多确认一次换来的是不会因为误发文件泄露信息。确认框里会列出即将导出的表与字段，每次都要重新确认。确认框里的表与字段列表来自本次导出范围，改动导出范围后需要重新确认一次。核算员庄琪提到：「脱敏之后还能按编号对账，这一点比字段打了码更重要。」

导出的文件不包含任何运行时凭据，也不写入日志路径与机器名，避免在跨部门流转时泄露环境信息。XLSX 导出在体验版同样可用，日志保留期按版本区分：体验版 15 天、专业版 200 天，因此超过保留期的批次无法再次导出，需要在批次结束前保存。失败重试成功率目前为 99.4%，配合三表对账可以把剩余 0.6% 逐条定位到具体原因。如果需要在批次结束前把报表发给外部，建议额外导出脱敏版，原始版留在本机工作目录。