Rails ActiveStorage大文件流式传输内存泄漏问题求助

安全阿岳

2026-8-21

Rails ActiveStorage 流式大文件内存持续膨胀问题的排查与解决

问题背景

作为Ruby和Rails新手，我在使用ActiveStorage流式传输约1GB大文件时遇到了内存异常问题：每次下载后应用内存会增加约文件大小，且手动调用GC.start也无法回收内存，内存随每次下载持续上升，并未如预期趋于平稳。

控制器代码如下：

def content
  file = CloudFile.find_by(id: params[:id])

  if file && file.content && file.content.attached?
    send_blob_stream file.content
  else
    head :not_found
  end
end

测试流程：

启动服务器，记录初始内存占用
下载1GB文件后，内存占用显著上升
调用POST /api/gc/start手动触发GC，内存无下降
再次下载该文件，内存继续增长

可能原因分析

send_blob_stream默认缓冲策略问题
部分场景下，send_blob_stream的默认配置并未真正实现流式传输，而是将文件内容全部加载到内存后再逐步发送。比如部分第三方存储服务的适配器，可能会预读取整个文件到内存，导致内存占用飙升。
Blob对象引用未被正确释放
如果file.content（即ActiveStorage::Blob对象）在请求结束后仍被隐式引用持有（比如未清理的日志上下文、全局变量、循环引用），会导致GC无法回收其关联的内存块。
Ruby内存分配特性的误判
虽然Ruby不会主动将内存释放回操作系统，但同一进程内重复分配相同大小的内存时，理应复用已分配的堆空间。内存持续增长说明内存块被永久持有，并非单纯未释放给操作系统的情况。

解决方案

1. 显式指定流式传输的缓冲大小

修改send_blob_stream调用，指定较小的分块大小，强制分块读取文件，避免一次性加载整个文件到内存：

send_blob_stream file.content, chunk_size: 1024*1024 do |chunk|
  response.stream.write(chunk)
end

这里设置的chunk_size为1MB，可根据服务器性能调整，核心是控制单次读取的字节数。

2. 主动清理Blob对象引用

在请求结束后显式解除对Blob相关对象的引用，打破可能存在的循环引用，帮助GC回收内存：

def content
  file = CloudFile.find_by(id: params[:id])

  if file && file.content && file.content.attached?
    blob = file.content
    send_blob_stream blob, chunk_size: 1024*1024
    # 显式置空解除引用
    blob = nil
    file.content = nil
    file = nil
  else
    head :not_found
  end
end

3. 检查存储服务适配器的流式支持

如果使用S3、阿里云OSS等第三方存储服务，确认对应的ActiveStorage适配器是否真的支持流式读取。部分适配器可能会将文件临时下载到本地内存而非流式传输，可切换到本地存储测试，排除存储服务端的问题。

4. 使用内存分析工具定位泄漏点

借助memory_profiler gem分析内存使用情况，找出未被回收的对象：

# Gemfile中添加
gem 'memory_profiler', group: :development

# 临时在控制器中加入分析代码
def content
  report = MemoryProfiler.report do
    file = CloudFile.find_by(id: params[:id])
    if file && file.content && file.content.attached?
      send_blob_stream file.content
    else
      head :not_found
    end
  end
  report.pretty_print(to_file: 'memory_report.txt')
end

通过报告中的retained objects项，定位被持续持有内存的对象类型，找到泄漏根源。

5. 调整服务器配置优化内存复用

如果使用Puma服务器，可调整进程数和线程数，启用preload_app!让子进程共享父进程内存，减少重复分配：

# config/puma.rb
workers Integer(ENV['WEB_CONCURRENCY'] || 2)
threads_count = Integer(ENV['MAX_THREADS'] || 5)
threads threads_count, threads_count

preload_app!

on_worker_boot do
  ActiveRecord::Base.establish_connection
end

总结

内存持续增长的核心原因大概率是文件内容被意外加载到内存且未被正确回收，通过显式控制缓冲大小、清理引用、排查适配器实现，基本可以解决问题。若仍无法解决，使用内存分析工具定位具体泄漏点是最有效的方法。

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

Rails ActiveStorage大文件流式传输内存泄漏问题求助

问题背景 #

可能原因分析 #

解决方案 #

1. 显式指定流式传输的缓冲大小 #

2. 主动清理Blob对象引用 #

3. 检查存储服务适配器的流式支持 #

4. 使用内存分析工具定位泄漏点 #

5. 调整服务器配置优化内存复用 #

总结 #