为什么Slack的files.list端点返回空files数组但分页显示有1803个文件？

你遇到的“返回文件数组为空但总文件数显示1803”的现象，根源是Slack API对不同类型token的权限边界做了强制过滤，和你已经配置的files:read、files:write权限本身没有关系。

具体逻辑说明 #

• 调用files.list接口时，返回内容会自动按照当前调用token的可见范围做权限裁剪，不会把事先统计的所有文件全量返回。
• 你当前使用的是xoxb前缀的bot token，这类token天生的可见范围非常受限：仅能枚举两类文件：
  • bot自身上传的文件
  • bot被明确邀请加入的频道、对话里公开共享的文件
• 接口返回的paging.total是整个工作区全量文件的统计数值，不是当前bot权限下可访问的文件数，两个值的统计口径完全独立，因此会出现“总计数显示有上千文件，但实际返回列表为空”的错位。

对应解决方式 #

• 如果你需要全量清理工作区文件、释放存储空间，不能使用bot token枚举所有文件，需要替换为拥有工作区管理员权限的用户身份token（xoxp前缀），给该token授权files:read权限后，才能跨频道、跨用户枚举全量工作区文件。
• 如果你坚持使用bot token完成清理，需要手动把bot邀请到每一个需要清理文件的频道中，让bot获得对应频道的文件访问权限，此时调用files.list才能拿到对应频道下的文件列表——这种方式需要覆盖工作区所有频道，操作成本较高，不适合大规模清理场景。
• 注意：你当前请求里加的show_files_hidden_by_limit=true参数，仅对有访问权限的文件生效，无法突破bot本身的可见范围限制。

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