升级Rails 7时Regexp.union调用String#to_regexp猴子补丁的原因

我正在将Rails应用升级至Rails 7，遇到一个问题：自定义的String#to_regexp猴子补丁会导致程序报错。原因是Rails 7依赖的IRB v1.14.1中存在一行代码：

ASSIGN_OPERATORS_REGEXP = Regexp.union(%w[= += -= *= /= %= **= &= |= &&= ||= ^= <<= >>=])

我在猴子补丁中加入调试代码后发现，调用Regexp.union时会触发该补丁，但无法在调用栈中找到明确的调用路径。以下是复现步骤及报错信息：

irb(main):063* class String
irb(main):064*   def to_regexp
irb(main):065*     puts "String#to_regexp called"
irb(main):066*     Regexp.new(self)
irb(main):067*   end
irb(main):068> end
=> :to_regexp
irb(main):070> Regexp.union
=> /(?!)/
irb(main):071> Regexp.union %w[:=]
String#to_regexp called
=> /:=/
irb(main):072> Regexp.union %w[:= aabb]
String#to_regexp called
String#to_regexp called
=> /(?-mix::=)|(?-mix:aabb)/
irb(main):073> Regexp.union %w[:= aabb +=]
String#to_regexp called
String#to_regexp called
String#to_regexp called
(irb):66:in `initialize': target of repeat operator is not specified: /+=/ (RegexpError)
    from (irb):66:in `new'
    from (irb):66:in `to_regexp'
    from (irb):73:in `union'
    from (irb):73:in `<main>'

原因解释 #

Ruby的Regexp.union方法在处理传入参数时，遵循Ruby内置的类型转换约定：如果参数对象实现了to_regexp方法，会优先调用该方法将对象转为正则表达式，而非使用默认的转义逻辑。

你给String类添加to_regexp猴子补丁后，Regexp.union处理每一个字符串参数时都会触发这个自定义方法。而Regexp.union原本会自动对字符串中的正则特殊字符（比如+、*等）进行转义，但你的补丁直接调用Regexp.new(self)跳过了这一步，导致像"+="这类包含正则语法字符的字符串无法被正确解析，进而抛出RegexpError。

解决方案 #

1. 转义特殊字符：修改猴子补丁，在创建正则前转义字符串中的特殊字符：

class String
  def to_regexp
    Regexp.new(Regexp.escape(self))
  end
end

2. 限定适用场景：让to_regexp只处理符合特定格式的字符串（比如带分隔符的正则字符串"/pattern/i"），避免干扰普通字符串：

class String
  def to_regexp
    if start_with?('/') && end_with?('/')
      flags = self[-2] if self[-2] =~ /[mix]/
      Regexp.new(self[1..-2], flags ? Regexp.const_get(flags.upcase) : 0)
    else
      Regexp.new(Regexp.escape(self))
    end
  end
end

3. 重命名方法：将猴子补丁的方法名改为非标准名称（比如to_custom_regexp），避免与Ruby的类型转换约定冲突。

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