Rails内嵌Gem测试报错排查：未初始化常量等问题

我来帮你一步步解决这些测试报错的问题，这些问题本质上都是Gem的依赖声明、文件加载逻辑没处理好导致的：

1. 修复IpLocator::Service找不到的问题 #

你的spec_helper里虽然require 'ip_locator'，但如果你的Gem主文件（lib/ip_locator.rb）没有自动加载service.rb，测试环境就找不到这个类。

解决方案： #

修改lib/ip_locator.rb，添加对Service类的加载：

# lib/ip_locator.rb
require_relative 'ip_locator/service'

module IpLocator
  # 可在此添加Gem版本信息或全局逻辑
  VERSION = "0.1.0"
end

这样当你require 'ip_locator'时，会自动加载service.rb，测试环境就能找到IpLocator::Service了。

2. 修复Singleton常量未找到的问题 #

你的Service类include Singleton，但这个模块属于Ruby标准库，需要显式require才能使用。

解决方案： #

在lib/ip_locator/service.rb顶部添加必要的require语句：

# lib/ip_locator/service.rb
require 'singleton'
require 'maxminddb' # 提前加载后续要用到的依赖

module IpLocator
  class Service
    include Singleton
    attr_reader :db

    def initialize
      # 后续会优化数据库路径，先保持原有逻辑
      @db = MaxMindDB.new('db/GeoLite2-City.mmdb')
    end

    def locate(ip)
      db.lookup ip
    end
  end
end

3. 修复MaxMindDB常量未找到的问题 #

这个是因为你的Gem没有正确声明对maxminddb依赖的引用，导致测试环境没有安装或加载这个库。

解决方案： #

步骤1：在Gem的gemspec文件中声明依赖

打开ip_locator.gemspec，添加依赖声明：

# ip_locator.gemspec
spec.add_dependency "maxminddb", "~> 0.1.0" # 替换为你实际使用的版本号

执行bundle install确保依赖被安装到测试环境。

步骤2：确保测试环境加载依赖

你的spec_helper里已经有Bundler.setup，这会加载Gemfile中的依赖，同时要确保Gemfile包含必要的测试依赖：

# Gemfile
source 'https://rubygems.org'

gemspec

group :development, :test do
  gem 'rspec'
  gem 'byebug'
end

4. 处理GeoLite2数据库文件的路径问题 #

测试环境中，Service初始化时用的相对路径'db/GeoLite2-City.mmdb'可能找不到文件，建议把数据库文件放到Gem的data目录，用绝对路径加载：

修改service.rb的初始化代码：

def initialize
  db_path = File.expand_path('../../data/GeoLite2-City.mmdb', __FILE__)
  @db = MaxMindDB.new(db_path)
end

将GeoLite2-City.mmdb放到ip_locator/data/目录下，同时在gemspec里声明这个数据文件：

# ip_locator.gemspec
spec.files += Dir["data/**/*"]

5. 验证测试代码 #

现在你的测试代码可以保持原有逻辑，无需修改：

require 'spec_helper'

RSpec.describe IpLocator do
  describe 'ip_locator' do
    context 'when the data exists' do
      let(:ip) { '74.125.225.224' }
      subject do
        IpLocator::Service.instance.locate ip
      end

      it 'return country data' do
        expect(subject.found).to be_truthy
      end
    end
  end
end

运行rspec，测试应该就能正常通过了。

内容的提问来源于stack exchange，提问作者Luiz E.