Rails 7.0.8.4应用无法加载自定义转换器，自动加载异常求助

问题背景 #

基于Rails 7.0.8.4开发的产品管理应用，通过CSV上传产品规格并入库，需将CSV中部分字符串字段转为浮点数。最初在输入服务内编写的转换逻辑正常运行，但将代码迁移到app/converters/tire_conversions.rb模块后，调用时触发uninitialized constant Converters错误，已确认目录位置正确，添加自动加载路径后仍无效。

相关代码 #

初始有效转换代码 #

product_data = row.to_hash.compact.merge(brand_id: brand.id)
product_data[:tire_width_inch] = row[:tire_width_inch].to_f if row[:tire_width_inch].present?
product_data[:tire_width_mm] = row[:tire_width_mm].to_f if row[:tire_width_mm].present?
product_data[:weight_g] = row[:weight_g].to_f if row[:weight_g].present?

转换器模块代码（app/converters/tire_conversions.rb） #

module Converters
  module TireConversions
    def self.convert(row)
      row[:tire_width_inch] = row[:tire_width_inch].to_f if row[:tire_width_inch].present?
      row[:tire_width_mm] = row[:tire_width_mm].to_f if row[:tire_width_mm].present?
      row[:weight_g] = row[:weight_g].to_f if row[:weight_g].present?
      row
    end
  end
end

调用代码 #

def convert_row_based_on_type(row)
    return row unless row[:type].present?

    converter_module = "Converters::#{row[:type]}Conversions".constantize
    converter_module.convert(row)
  rescue NameError
    row
  end

错误日志 #

Attempting to load converter module: Converters::TireConversions
Converter not found for type: Tire
uninitialized constant Converters

排查与解决步骤 #

1. 对齐Zeitwerk自动加载规则（Rails 7默认加载器） #

Zeitwerk对文件路径与模块结构有严格约定：

• 顶层模块Converters对应目录app/converters
• 子模块TireConversions对应文件app/converters/tire_conversions.rb（下划线分隔、全小写）
  你的文件结构符合要求，但需确认Rails已识别app/converters为自动加载目录。

2. 显式配置自动加载路径 #

在config/application.rb中添加以下配置，确保Rails能扫描到自定义转换器目录：

config.autoload_paths << Rails.root.join('app/converters')
config.eager_load_paths << Rails.root.join('app/converters')

修改后重启Rails服务/控制台，测试模块是否能正常加载。

3. 检查文件名与模块名拼写 #

确认文件名是tire_conversions.rb（注意复数形式），模块名是TireConversions（驼峰对应下划线文件名），避免大小写或拼写错误导致加载失败。

4. 临时手动require验证 #

在调用转换器的文件顶部添加手动require，验证模块本身是否能正常加载：

require_relative '../converters/tire_conversions'

如果手动require后问题解决，说明自动加载路径配置仍有问题，需重新检查config/application.rb的加载设置，或确认Rails环境的自动加载开关（开发环境默认开启，生产环境需开启eager_load）。

5. 控制台调试定位问题 #

在Rails控制台中执行以下命令，逐步排查加载问题：

# 尝试直接引用模块
Converters::TireConversions

# 若报错，手动加载文件
require Rails.root.join('app/converters/tire_conversions')

# 再次尝试引用模块
Converters::TireConversions

通过此步骤可快速定位是路径配置错误，还是模块定义本身存在问题。

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