Solidus集成Correios API计算运费时触发NameError错误

看起来你遇到的核心问题是Ruby在Solidus的命名空间下找不到Correios常量，而命令行脚本正常是因为环境加载逻辑不同。下面是具体的解决方案：

问题根源 #

命令行脚本里你手动require 'correios-frete'加载了gem，并且脚本在顶级命名空间运行，所以能直接找到Correios；但在Solidus的模型文件中，你注释掉了require 'correios-frete'，加上代码处于Spree::Calculator::Shipping::CorreiosApi子命名空间，Ruby会优先在当前命名空间下查找Correios，自然找不到顶级的gem常量。

解决方案 #

1. 确保gem已正确引入项目 #

首先确认你的Gemfile里已经添加了correios-frete：

# Gemfile
gem 'correios-frete'

执行bundle install确保gem被安装到项目依赖中。

2. 取消模型文件中的require注释 #

在app/models/spree/calculator/shipping/correios_api.rb里取消require 'correios-frete'的注释，让Ruby加载gem的常量：

# app/models/spree/calculator/shipping/correios_api.rb
# frozen_string_literal: true
require 'correios-frete' # 取消这行注释
require_dependency 'spree/calculator'
require_dependency 'spree/shipping_calculator'

module Spree
  module Calculator::Shipping
    class CorreiosApi < ShippingCalculator
      # ... 剩余代码保持不变
    end
  end
end

3. （可选）强制引用顶级命名空间常量 #

如果上述步骤后仍有问题（比如存在命名空间冲突），可以在引用Correios时加上双冒号::，明确告诉Ruby去顶级命名空间查找：

frete = ::Correios::Frete::Calculador.new(
  :cep_origem => "22790-671", 
  :cep_destino => "06783-090", 
  :peso => 7.3, 
  :comprimento => 30, 
  :largura => 20, 
  :altura => 35
)

验证方法 #

重启你的Rails服务器（如果用了Spring，执行spring stop再重启），然后触发运费计算逻辑，应该就能正常创建Correios::Frete::Calculador实例了。

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