
用户提交了三份 PDF,关掉页面,稍后回来只想知道两件事:哪份能下载,哪份需要处理。如果页面直接把解析接口的「完成」显示成「可下载」,取文件或保存出错时,按钮已经亮了,用户点进去却拿不到结果。
我会把这两个状态分开:解析服务负责告诉应用结果是否已生成;应用只有在取回结果、核对内容并保存成功后,才显示「可下载」。用户回来时,页面读应用里每份文件的记录,不靠浏览器标签页记住进度。
每次提交前先存批次 ID、文件 ID 和输入版本。接口受理后,把任务 ID 写回对应的文件记录。至少再存解析状态、结果保存状态和已保存结果的存储键。写回状态前核对输入版本和任务 ID,避免迟到的旧任务覆盖新文件的状态。
解析状态 | 结果保存状态 | 页面怎么显示 |
|---|---|---|
处理中 | 未取回 | 解析中 |
失败 | 未取回 | 解析失败;按原因决定能否重试 |
成功 | 待取回或保存中 | 解析完成,正在准备下载 |
成功 | 取回或保存失败 | 结果暂不可下载,优先尝试取回原结果 |
成功 | 已保存 | 可下载;请求时检查用户权限 |
这些是应用自己的状态,接入时再映射到服务返回的值。也别把 HTTP 200 当成解析成功:提交时要看业务响应是否受理,查询时要看目标文件的实际结果。
后台查到解析成功后,先下载到临时位置,按预期的输出格式检查能否打开。比如约定拿 ZIP,就检查压缩包可读、所需文件齐全,再保存到应用自己的存储。保存成功后,把存储键和「已保存」一起写回记录。如果同一任务被重复查询,先检查该文件版本是否已经保存,避免重复交付。
如果链接失效,先看应用有没有保存副本;没有副本,再看当前接口能不能为原任务重新提供有效地址。只有这两条路都走不通,才按重试规则决定是否重新解析。这样,一份结果取不回来时,可以处理这一份,已经能下载的文件照常交付。
用一页合成 PDF 验证了 ComPDF 全文解析 API:提交后拿到任务 ID,两次查询返回 TaskProcessing,第三次为 TaskFinish,且该文件的结果 ZIP 当时可下载。另一次把两份 PDF 放在同一个请求中,接口返回 04007,没有任务 ID。因此,对这个接口应由应用逐份提交、自己汇总批次进度。这里验证的是单份文件的接口链路,未实测链接到期或多文件失败隔离。
先用测试文件或模拟接口让 A 正常完成并保存,让 B 返回解析失败,让 C 解析成功但暂时取不到结果。刷新页面后,预期 A 仍可下载,B 显示失败,C 显示结果暂不可下载。接着只让 C 的原结果恢复可取,确认应用能补取并交付 C,且没有为 A 或 B 重新发起解析。
接到自己的系统前,先用一份文件走完从提交到下载的路径,再做上面的三文件检查。如果接口已报告成功而按钮仍灰,先查结果有没有取回、校验并保存;只有解析本身失败或原结果确认无法恢复,才回到重新提交这一步。
图:单份合成 PDF 的实际查询记录。图中的下载是从解析服务取结果,应用仍需检查并保存之后再提供下载。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。