一、缺失记录可能藏在同一张发票内部
导出文件即使包含全部父发票，也可能缺少发票明细。Stripe 官方明确说明：读取发票时，lines 属性只包含前面一小部分明细，完整列表需要通过另一个可分页的 URL 获取。[8] 因此，问题不是 Search 的更新延迟，也不是转账与发票如何匹配，而是导出跨越了父子资源边界。判断完成时，不能只数父发票 ID，还必须确认每张发票的明细集合已经处理完毕。
二、公开案例揭示了遗漏路径
Airbyte 的一项公开修复请求描述了这样的缺陷：增量同步展开内嵌的 lines.data，分页器却只检查外层事件列表，导致发票明细遗漏。其修复方案是在嵌套列表表明还有数据时，单独获取完整发票明细。[11] 这是第三方公开报告，并非本文作者运行的测试。另外，Stripe Java 的历史问题提出：待生成发票超过十条明细时，需要继续分页，而且后续请求必须保留预览参数。[9] 这证明开发者确实遇到过明细遍历需求，但不能据此声称当年的 SDK 缺陷今天仍然存在。
三、明确启动发票明细的独立遍历
针对已有发票，使用 GET /v1/invoices/{id}/lines。官方将其定义为读取完整分页明细列表的端点，limit 范围为 1 至 100，默认值为 10。[8] 一种容易审核的导出方案是：对每张选中的发票都从这个端点开始读取，不把父对象附带的明细直接当作完整数据集。若选择复用内嵌明细，则必须明确检查该子列表的完成状态。发票金额看起来合理、父对象读取成功，都不能替代明细集合的完整性判断。
四、续页使用明细 ID，而非发票 ID
写完一页明细后，检查该子响应的 has_more；若为 true，就把本页最后一条明细的 ID 放入 starting_after，继续请求同一张发票的明细端点，直到返回 false。[8][2] 发票 ID 始终留在路径中，不是续页游标。需要反向导航时，ending_before 使用当前页第一条对象的 ID，而且不能与 starting_after 同传。[8][1] 不要自行对不透明 ID 排序；应沿端点返回的序列推进。最后一页必须先处理完，才能把该发票标记为完成。
五、自动分页不能跨越父子边界
Stripe 的自动分页辅助方法会持续发出请求，直到当前遍历的列表结束。[2] 然而，在父发票列表上调用自动分页，不等于遍历每张发票单独的明细 URL。[8] 建议将流程拆成三个动作：枚举选中的发票 ID、为每张发票登记明细导出任务、分别完成每个子迭代器。输出行应保留所属发票标识。事件驱动的导入也需要区分事件列表的游标与嵌套明细的游标；Airbyte 报告正好展示了只检查外层状态的后果。[11]
六、每张发票独立保存写入断点
建议子任务状态包含账户上下文、测试或正式环境、API 版本、发票 ID、端点、最后已提交的明细 ID，以及完成标记。父列表的枚举进度另行保存。先可靠写入数据，再推进明细游标；用账户、发票和明细标识组合实现可重放写入。若工作进程在数据提交后、断点推进前停止，恢复时不应产生重复导出行。若返回空页但仍声称有后续结果，或游标一直不变，应保留错误状态，而不是默认成功。这些是应用层保护，并非 Stripe 的快照一致性或恰好一次处理承诺。
七、关闭任务前审核子资源完成情况
建议记录选中的发票数、已完成子任务数、已提交明细行数，以及未解决的失败。如果旧导入器曾把内嵌明细当作全部内容，就需要重新检查历史导出；修复今后的读取逻辑，并不能自动证明旧数据完整。本文仅讨论有权限访问的受支持 Stripe 账户中的已有发票明细导出，不覆盖待生成发票模拟、Search 或 PayIn 功能。投产前应实际验证子列表跨多页，以及写入后中断再恢复的场景。本文没有声称执行过账户导出或代码测试；遍历完整只是账务核查的输入条件，不代表对账已经成功。
来源与日期
技术行为以官方文档为依据；社区提问只说明定性需求。于2026-09-22读取核验，检索日期不等于原文发布日期；未注明的日期仍视为未知。本文为文档研究，不是实际账户测试，不代表 PayIn 产品功能，也不是法律、税务或财务意见。账户资格与地区可用性需要另行确认。
- [1] 分页参数与响应格式 · 发布日期未注明; 更新日期未注明 · 核验于2026-09-22。
- [2] 列表与搜索的分页工作方式 · 发布日期未注明; 更新日期未注明 · 核验于2026-09-22。
- [8] 读取发票的完整明细列表 · 发布日期未注明; 更新日期未注明 · 核验于2026-09-22。
- [9] 历史开发者问题：待生成发票明细分页丢失原请求参数 · 发布于2018-02-19; 更新于2022-11-23 · 核验于2026-09-22。
- [11] 社区修复讨论：事件内嵌明细截断时读取完整发票明细 · 发布于2026-08-26; 更新于2026-09-21 · 核验于2026-09-22。