Aspera Node API /files/{id}/files接口返回非最新数据问题咨询

接口缓存机制说明 #

/files/{id}/files 接口确实存在服务端内置的目录元数据缓存，这也是官方标注它性能更优的核心原因：

• 该接口默认的缓存TTL为2-5分钟，请求时优先读取缓存的目录结构，不会每次都实时遍历底层S3存储的对象列表，所以新上传的文件不会立刻出现在返回结果中
• /files/browse接口没有该缓存机制，每次请求都会实时拉取存储侧的文件列表，所以能立刻返回新上传的文件
• AoC控制台上传完成后会主动触发对应目录的缓存失效逻辑，所以你在控制台操作后能立刻看到更新后的文件列表，这是官方内部操作自带的缓存清理逻辑，未在公开文档中明确标注

可落地的解决方法 #

你可以根据业务场景选择以下方案：

• 上传流程完成后，主动调用AoC的目录元数据刷新接口，传入目标父文件夹的ID触发缓存清理，清理完成后10秒内再调用/files/{id}/files接口就能拿到最新的文件列表，该方案不会影响接口本身的查询性能
• 调用/files/{id}/files接口时附加查询参数cache=false，强制接口走实时查询路径，该方案不需要修改上传流程，适合目录文件数量少、对性能损耗不敏感的场景
• 如果你的业务对实时性要求极高，且目录查询的并发量不大，可以切回原来的/files/browse接口，该接口不存在缓存延迟问题

内容的提问来源于stack exchange，提问作者Tim