Ruby3 Rails6集成QuickBooks出现URI:Module无escape方法错误如何解决

问题根因 #

你自身编写的业务代码没有调用URI.escape，报错来自你依赖的oauth gem旧版本：旧版oauth gem内部封装认证逻辑时调用了Ruby 3中已移除的URI.escape方法，触发了报错。

解决方案 #

方案一（优先推荐）：升级兼容Ruby 3的oauth gem版本

1. 打开项目根目录的Gemfile，找到oauth gem的声明，修改版本要求为：

gem 'oauth', '>= 0.5.6'

2. 终端执行更新命令：
   bundle update oauth
3. 重启Rails服务，重新走QuickBooks认证流程即可解决报错。

方案二（适配无法升级gem的场景）：添加兼容补丁

如果项目有其他依赖限制，无法升级oauth gem，可以手动加补丁补回URI.escape方法：

1. 在config/initializers目录下新建uri_escape_patch.rb文件，写入以下代码：

unless URI.respond_to?(:escape)
  module URI
    def self.escape(*args)
      URI::DEFAULT_PARSER.escape(*args)
    end
  end
end

2. 重启Rails服务即可生效。

补充说明 #

你当前使用的是QuickBooks的OAuth 1.0a认证接口，Intuit官方已经推荐切换到OAuth 2.0认证体系，如果后续长期维护该集成功能，可以考虑后续迭代时升级认证方式，减少兼容性问题。

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