Rails 7使用gravatar_image_url报错：undefined method `escape' for URI:Module

这个问题我之前帮朋友排查过，本质是Ruby 3.0+ 移除了URI.escape方法，而你使用的gravatar_image_tag gem版本未适配Ruby 3/Rails 7，依然在调用这个已废弃的API，所以触发了undefined method 'escape' for URI:Module错误。下面给你几种可行的修复方案：

方案一：升级gravatar_image_tag到最新兼容版本 #

最新版本的gravatar_image_tag已经修复了Ruby 3的适配问题，优先尝试升级：

• 打开项目根目录的Gemfile，找到gem 'gravatar_image_tag'这一行，修改为指定兼容版本（或者直接不指定版本让bundle拉取最新）：

  gem 'gravatar_image_tag', '>= 1.2.0' # 1.2.0及以上版本已适配Ruby3
  

• 执行bundle更新命令：

  bundle update gravatar_image_tag
  

• 重启Rails服务器，再测试视图中的gravatar_image_url调用，应该就能正常工作了。

方案二：手动重写gravatar生成方法（不依赖gem） #

如果升级gem后还是有问题，或者不想依赖第三方gem，可以自己在helper里实现一个gravatar链接生成方法：

1. 打开app/helpers/application_helper.rb，添加以下方法：

   def custom_gravatar_url(email, size: 80)
     return unless email.present?
     # 使用Ruby 3推荐的URI.encode_www_form_component处理转义
     hashed_email = Digest::MD5.hexdigest(email.downcase.strip)
     encoded_size = URI.encode_www_form_component(size)
     "https://www.gravatar.com/avatar/#{hashed_email}?s=#{encoded_size}"
   end
   

2. 修改视图中的代码，替换原有的gravatar_image_url：

   <%= image_tag custom_gravatar_url(current_user.email, size: 100), class: "rounded-circle" %>
   

3. 重启服务器测试即可。

方案三：临时修复URI.escape方法（不推荐，仅应急用） #

如果你暂时无法升级gem或修改代码，可以临时在项目中重新定义URI.escape方法（不推荐长期使用，因为Ruby官方已废弃该方法）：

1. 在config/initializers/uri_patch.rb文件中添加以下代码：

   module URI
     def self.escape(str, unsafe = /[^#{PATTERN::UNRESERVED}]/)
       URI.encode_www_form_component(str).gsub('+', '%20')
     end
   end
   

2. 重启服务器，报错会暂时消失，但这只是临时补丁，建议后续还是升级gem或替换为自定义方法。

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