Rails deliver_later发邮件触发未关联Requester模块参数错误排查
异常根因
问题核心是全局方法污染导致的方法查找优先级冲突:
- 你定义的
Requester模块内的post、request方法都是无self前缀的实例方法,本身仅能被include该模块的类实例调用。 - 项目中存在代码将
Requester模块直接include到了Ruby顶层的Object类(常见场景包括初始化文件中直接写include Requester、甚至在requester.rb末尾直接调用include),等同于给所有Ruby对象都注入了这两个自定义方法。 - Rails、delayed_job内部本身存在名为
request的无参方法,原本用于获取请求上下文、队列执行元信息。同步发送邮件(deliver_now)时,代码运行在ActionController实例上下文,控制器自带的request方法在方法查找链中的优先级远高于Object层的自定义方法,因此不会触发错误。 - 异步发送邮件(
deliver_later)时,任务由delayed_job常驻Worker在顶层main上下文执行,该上下文没有控制器层的request方法定义,方法查找直接命中你注入到Object的Requester#request方法。该方法要求至少2个入参,实际被Rails内部逻辑以无参形式调用,因此抛出参数数量不匹配的错误。由于不存在显式的跨模块调用逻辑,从表面上看Mailer流程完全没有关联Requester模块。
修复步骤
- 立刻移除所有将
Requester模块直接include到Object、顶层main上下文的代码,包括初始化文件、模块定义文件末尾的全局include逻辑。 - 调整
Requester模块定义,将原本的实例方法改为模块方法,避免依赖include逻辑,修正后的代码参考:
# lib/requester.rb module Requester def self.post(rel_url, body, token = nil, headers = {}) request(:post, rel_url, body, token, headers) end def self.request(method, rel_url, body = nil, token = nil, additional_headers = {}) headers = { 'Content-Type': 'application/json' } headers[:Authorization] = "Bearer #{token}" if token headers.merge!(additional_headers) unless additional_headers.empty? HTTParty.send(method.to_sym, "#{base_url}#{rel_url}", headers: headers, body: body) end # 同步将base_url相关方法改为模块级 def self.base_url # 替换为项目实际的base_url获取逻辑 ENV['REQUESTER_BASE_URL'] end end
- 项目中所有原本直接调用
post、request的地方,全部改为显式调用模块方法,即Requester.post(xxx)、Requester.request(xxx),彻底避免全局方法污染。 - 修复后重启delayed_job Worker进程,因为常驻Worker会缓存旧的类定义,不重启无法加载修正后的逻辑。
内容的提问来源于stack exchange,提问作者Int'l Man Of Coding Mystery
相关产品推荐
相关产品推荐

