Rails捕获自定义异常触发NameError问题求助

你遇到的问题核心是控制器在自身命名空间下找不到顶级的CustomExceptions模块，报错信息里的uninitialized constant Api::V1::UsersController::CustomExceptions已经给出了明确提示：Rails默认会在当前控制器的Api::V1命名空间下查找这个模块，但你的CustomExceptions是顶级模块，所以需要调整引用方式，同时确保模块能被Rails正确加载。

下面是具体的解决步骤：

1. 确保自定义异常文件的存放路径正确 #

Rails的自动加载机制（Zeitwerk）会优先加载app目录下的文件，建议把你的自定义异常文件放在app/exceptions/custom_exceptions.rb（如果exceptions目录不存在，直接新建即可），这样Rails启动时会自动加载该文件，无需额外配置。

你的异常文件代码可以保持不变：

# app/exceptions/custom_exceptions.rb
module CustomExceptions
  class EmptyObject < StandardError; end
  class WrongParams < StandardError; end
  class Unauthorized < StandardError; end
end

2. 在控制器和服务层使用顶级命名空间引用异常 #

因为控制器位于Api::V1命名空间下，直接写CustomExceptions::EmptyObject会被Rails解析为Api::V1::CustomExceptions::EmptyObject，这显然不是你定义的模块。所以需要在模块名前加上::前缀，告诉Rails去顶级命名空间查找目标模块：

服务层抛异常示例 #

# 示例：app/services/user_operation_service.rb
class UserOperationService
  def execute(params)
    raise ::CustomExceptions::WrongParams, "缺少必要参数" if params[:user].nil?
    raise ::CustomExceptions::EmptyObject, "查询到的用户对象为空" if target_user.nil?
    # ...其他业务逻辑
  end
end

控制器捕获异常示例 #

# app/controllers/api/v1/users_controller.rb
module Api
  module V1
    class UsersController < ApplicationController
      def update
        UserOperationService.new.execute(params)
      rescue ::CustomExceptions::WrongParams => e
        render json: { error: e.message }, status: :unprocessable_entity
      rescue ::CustomExceptions::EmptyObject => e
        render json: { error: e.message }, status: :bad_request
      rescue ::CustomExceptions::Unauthorized => e
        render json: { error: e.message }, status: :unauthorized
      end
    end
  end
end

3. 可选：如果异常文件放在lib目录的配置 #

如果你一定要把异常文件放在lib目录下，需要在config/application.rb里添加自动加载路径，确保Rails能找到它：

# config/application.rb
module YourAppName
  class Application < Rails::Application
    # ...其他配置项
    config.autoload_paths << Rails.root.join('lib')
  end
end

同时要保证lib/custom_exceptions.rb的文件名和模块名完全匹配，这样Zeitwerk才能正确加载模块。

完成以上调整后，控制器就能正确识别你的自定义异常模块，不会再触发NameError错误了。

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