Ruby on Rails导入CSV时触发ActionDispatch::Cookies::CookieOverflow错误

问题根源 #

ActionDispatch::Cookies::CookieOverflow 是因为Rails默认使用CookieStore存储session/flash数据，而浏览器对单个cookie的大小限制通常在4KB左右。你的场景中，大概率是以下两种情况触发：

1. CSV验证错误条数过多，错误信息被存入session/flash（可能是模板或隐式机制导致），超出cookie容量
2. 异常信息（ex.message）过大，通过alert参数存入flash时撑爆cookie

具体解决方案 #

1. 简化异常提示，避免大文本存入flash #

在rescue块中，不要直接把异常的完整信息传给alert，改用简洁提示：

rescue => ex
  AppSignaler.set_client_error(ex, @client.try(:id))
  File.delete(file_path) if File.exist?(file_path)
  # 替换原alert为简洁提示，避免大文本存入flash
  redirect_to upload_annual_sales_client_url(@client), alert: '文件处理失败，请检查文件格式或联系管理员'
end

2. 限制验证错误的数量，避免错误列表过大 #

修改SpektrixReportHandler#validate_csv方法，限制返回的错误条数，防止错误信息体积过大：

def validate_csv
  json_schema_validator = mapping.dig(:schema_validator)
  errors = []
  max_display_errors = 20 # 设定最大显示错误数

  get_parsed_csv.each.with_index(1) do |row, index|
    # 达到错误上限后停止验证，减少错误输出
    break if errors.size >= max_display_errors

    data = row.to_hash
    json_errors = JSON::Validator.fully_validate(json_schema_validator, data.to_json, errors_as_objects: true)

    if json_errors.empty?
      csv_validator = CsvValidator.validate(data, mapping)
      unless csv_validator[:errors].try(:empty?)
        errors << ["行 #{index} 错误:"] + csv_validator[:errors]
      end
    else
      cleaned_errors = clean_json_errors(json_errors)
      errors << ["行 #{index} 错误:"] + cleaned_errors
    end
  end

  # 添加截断提示
  if errors.size == max_display_errors
    errors << ["已截断错误显示，共发现超过#{max_display_errors}条错误，请先修正已列出的问题"]
  end

  errors
end

3. 避免将大体积数据存入session/flash #

检查你的视图模板（比如validate_annual_sales.html.erb），确认没有将@validation_errors存入flash或session的逻辑。如果需要保留错误信息供页面渲染，直接通过实例变量传递即可，不要存入cookie存储的session/flash。

4. 切换Session存储方式（彻底解决大session问题） #

如果你的应用经常需要存储大体积数据到session，建议将默认的CookieStore替换为服务器端存储，比如RedisStore或ActiveRecordStore：

使用RedisStore（推荐）

首先添加redis相关gem到Gemfile：

gem 'redis'
gem 'redis-rails'

然后修改config/initializers/session_store.rb：

Rails.application.config.session_store :redis_store,
  servers: "redis://localhost:6379/0/session",
  expire_after: 24.hours,
  key: "_#{Rails.application.class.parent_name.downcase}_session"

使用ActiveRecordStore

运行生成session表的迁移：

rails generate session_migration
rails db:migrate

然后修改config/initializers/session_store.rb：

Rails.application.config.session_store :active_record_store, key: "_#{Rails.application.class.parent_name.downcase}_session"

5. 优化CSV解析逻辑（减少不必要的内存占用） #

当前get_parsed_csv每次调用都会重新读取并解析整个CSV，建议缓存解析结果，避免重复IO操作：

private

def get_parsed_csv
  @parsed_csv ||= CSV.parse(File.read(csv, encoding: 'bom|utf-8'), headers: true, force_quotes: true, header_converters: :symbol)
end

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