RSpec测试引入其他模块的Ruby模块时提示undefined method错误

业务代码 #

module Base
  module A
    include Base::B
  end
end

module Base
  module B
    module_function
    def my_method
      # 业务实现逻辑
    end
  end
end

测试代码 #

RSpec.describe Base::A do
  describe '.my_method' do
    it 'does something' do
      # 测试逻辑
    end
  end
end

运行报错 #

NoMethodError: undefined method `my_method' for Base::A:Module

报错核心是对Ruby中module_function的行为理解有偏差：

1. 用module_function标记的方法，会自动转为定义所在模块的模块私有单例方法，同时原实例方法会被设为私有实例方法
2. 你在Base::A中仅include Base::B，该操作只会把B的实例方法导入A的祖先链，不会导入B的单例方法
3. RSpec中describe '.my_method'的写法是测试模块/类直接调用的单例方法（也就是Base::A.my_method这种调用形式），而A本身从来没有获得过my_method这个单例方法，因此抛出方法不存在的异常。

额外说明：原测试代码里写的Rspec.describe存在拼写错误，正确常量名是RSpec（S大写），不过这不是触发本次NoMethodError的原因。

根据实际业务诉求选对应方案即可：

• 如果你希望my_method既能作为B的模块方法直接调用，又能被其他模块include后作为实例方法使用，把B里的module_function换成extend self即可：

  module Base
    module B
      extend self
      def my_method
        # 业务实现逻辑
      end
    end
  end
  

  这种写法下，如果要让A也能直接调用Base::A.my_method，只需要在A里额外加一行extend Base::B。
• 如果你要保留module_function的写法，直接修改A的代码，在include B的同时extend B，就能把B的方法导入为A的单例方法：

  module Base
    module A
      include Base::B
      extend Base::B
    end
  end
  

• 如果你本来的诉求是测试A被include到业务类后，类实例可以调用my_method方法，那测试写法本身有误：RSpec里#my_method才代表实例方法，.my_method代表类/模块自身的方法，需要调整测试用例的描述和调用逻辑，构造一个混入A的测试类实例来调用方法验证逻辑。

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