Rails应用用smarter_csv上传Unicode CSV至MySQL遇String转Hash类型错误

咱先把这个问题拆解清楚——你遇到的no implicit conversion of String into Hash错误，90%的概率是调用SmarterCSV.process时参数传错了，剩下的情况才和编码或版本有关。下面一步步给你排查解决：

1. 检查SmarterCSV.process的调用方式（最常见原因） #

smarter_csv的process方法第一个参数可以是文件路径字符串或文件对象，第二个参数必须是配置选项哈希。如果你把字符串（比如编码值）直接当成第二个参数传，或者误传了UploadedFile对象而不是路径，就会触发这个错误。

错误示例： #

# 错误1：直接传UploadedFile对象（不是路径/文件对象）
SmarterCSV.process(params[:file])

# 错误2：第二个参数传了字符串（期望是哈希）
SmarterCSV.process(params[:file].path, "UTF-8")

正确示例： #

def upload
  # 先获取上传文件的临时路径
  file_path = params[:file].path
  # 配置CSV解析选项（根据你的文件调整，比如分隔符、编码）
  options = {
    col_sep: ',',
    encoding: 'UTF-8', # 适配Unicode字符
    remove_empty_values: true
  }
  # 正确调用process方法
  csv_records = SmarterCSV.process(file_path, options)

  # 接下来遍历records保存到数据库
  csv_records.each do |record|
    YourModel.create!(record)
  end
end

如果不想用路径，也可以直接传入打开的文件对象：

params[:file].open do |file|
  csv_records = SmarterCSV.process(file, options)
  # 处理逻辑...
end

2. 处理Unicode文件的编码问题 #

如果你的CSV是UTF-8带BOM（Windows下常见），smarter_csv可能解析异常，甚至间接导致参数错误。可以先移除BOM再解析：

def upload
  file_content = File.read(params[:file].path, encoding: 'UTF-8')
  # 移除UTF-8 BOM标记
  file_content.gsub!("\xEF\xBB\xBF", '')
  
  # 写入临时文件再解析
  temp_file = Tempfile.new(['unicode_csv', '.csv'], encoding: 'UTF-8')
  temp_file.write(file_content)
  temp_file.close

  options = { encoding: 'UTF-8' }
  csv_records = SmarterCSV.process(temp_file.path, options)
  
  # 保存逻辑...
  
  temp_file.unlink # 清理临时文件
end

3. 更新smarter_csv到最新版本 #

旧版本的smarter_csv对参数的容错性较差，建议升级到最新稳定版：
在Gemfile中修改：

gem 'smarter_csv', '~> 2.0'

然后执行：

bundle update smarter_csv

4. 确保MySQL支持Unicode字符 #

最后，别忽略数据库端的配置——如果要保存全量Unicode字符（比如emoji），需要把表的字符集设为utf8mb4：
在迁移文件中添加：

create_table :your_models, options: 'ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci' do |t|
  # 你的字段定义
  t.string :name
  t.text :description
  # ...
end

如果是已存在的表，可以写迁移修改字符集：

def change
  execute "ALTER TABLE your_models CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
end

按照上面的步骤排查，应该能解决这个转换错误啦！

内容的提问来源于stack exchange，提问作者Marcos R. Guevara