Rails应用中如何获取S3存储桶目录内容并按年/月结构展示

实现思路 #

第一步：将S3返回的扁平文件Key转换为嵌套结构 #

首先拉取Datev_Documents根目录下所有文件的Key，按照「年-月-文件」的层级组装成嵌套哈希，避免视图层做复杂的逻辑处理，示例代码如下：

def get_structured_datev_files(s3_resource, bucket_name)
  # 拉取Datev_Documents目录下所有文件的Key
  all_file_keys = s3_resource.bucket(bucket_name).objects(prefix: 'Datev_Documents/').collect(&:key)
  # 初始化嵌套哈希结构：{ 年份 => { 月份 => [文件列表] } }
  structured_files = Hash.new { |h, year| h[year] = Hash.new { |h2, month| h2[month] = [] } }

  all_file_keys.each do |key|
    path_parts = key.split('/')
    # 过滤不符合层级规则的对象（比如空目录占位对象）
    next if path_parts.size < 4 || path_parts[3].blank?

    year = path_parts[1].to_i
    month = path_parts[2]
    file_name = path_parts[3]
    structured_files[year][month] << file_name
  end

  # 按年份倒序、月份正序排序后返回
  structured_files.sort_by { |year, _| -year }.to_h.transform_values do |months|
    months.sort.to_h
  end
end

第二步：控制器传递数据到视图 #

在对应控制器的动作中调用上述方法，将处理好的结构化数据赋值给实例变量传入视图：

# 建议将S3资源初始化放在config/initializers/aws.rb全局复用
@structured_files = get_structured_datev_files(s3_resource, '你的S3存储桶名称')

第三步：修改视图渲染逻辑 #

替换原有的硬编码年份、月份逻辑，直接遍历结构化数据生成层级列表，Slim格式视图示例：

h1 Datev File List

ul
  - @structured_files.each do |year, months|
    li
      h2 = year.to_s
      ul
        - months.each do |month, files|
          li
            h3 = month
            ul
              - files.each do |file|
                li = file

可选优化建议 #

• 缓存处理：如果文件数量多、更新频率不高，可以用Rails缓存将结构化数据缓存1-24小时，减少S3 API调用频次，提升页面加载速度。
• 空目录展示：如果需要展示无文件的月份，可在组装哈希时补全所有年份下的1-12月，对应值设为空数组即可。
• 下载功能扩展：如果需要支持文件点击下载，可以调用S3对象的presigned_url方法生成临时访问链接，在视图中绑定到文件名的a标签即可。

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