Ruby on Rails使用gon gem时出现非法UTF-8序列异常求助

这问题我之前排查过类似的，结合你的环境差异（本地Ruby2.3.3 vs C9的Ruby2.4.1）和报错堆栈，核心原因是Ruby 2.3.x与2.4.x在JSON序列化时对非标准UTF-8字符的处理逻辑不一致——Ruby2.4对非法UTF-8的容错性更强，而2.3会直接抛出异常。下面给你几个可行的解决思路：

1. 先定位问题数据 #

首先得确认是哪段通过gon传递的数据带了非法字符：

• 临时注释掉控制器里的gon.xxx = ...赋值语句，逐个恢复并重启测试，找到触发报错的那组数据。
• 重点检查从数据库、第三方接口获取的内容，比如旧数据里的乱码、特殊emoji、或者非BMP（超出基本多语言平面）的字符，这些都容易在Ruby2.3里触发UTF-8异常。

2. 手动清理非法UTF-8字符 #

找到问题数据后，用Ruby的scrub方法清理（Ruby2.3.3已经支持这个方法）：

• 如果是单个字符串：

  gon.user_name = user.name.to_s.scrub  # 把非法字符替换成默认的占位符
  

• 如果是哈希/数组这类复杂结构，写个递归方法清理所有字符串值：

  def scrub_utf8_data(obj)
    case obj
    when String
      obj.scrub
    when Hash
      obj.transform_values { |value| scrub_utf8_data(value) }
    when Array
      obj.map { |item| scrub_utf8_data(item) }
    else
      obj  # 非字符串类型直接返回
    end
  end
  
  # 在控制器里调用
  gon.order_details = scrub_utf8_data(raw_order_data)
  

3. 调整gon的JSON序列化配置 #

通过修改gon的初始化配置，让JSON序列化时自动处理非法字符：
在config/initializers/gon.rb中添加以下配置（如果文件不存在就新建一个）：

Gon.configure do |config|
  # 配置JSON序列化选项：替换非法字符，允许NaN值，转义HTML
  config.json_options = { invalid: :replace, allow_nan: true, escape_html: true }
end

这个配置会让gon在序列化数据时，自动把非法UTF-8字符替换成占位符，避免直接抛出异常。

4. 升级Ruby版本（长期推荐） #

Ruby2.3已经在2019年就停止维护了，不仅有这个UTF-8的问题，还存在安全漏洞和性能瓶颈。如果项目允许的话，升级到Ruby2.4.1或者更高的兼容版本（比如2.5.x，和Rails5.1.5完全适配），从根源上解决这类版本兼容问题。

试完上面的方法后，记得重启Rails服务器再测试，应该就能解决那个to_json的异常了。

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