[Rails] superclass mismatch for class エラーの原因と解決策

はじめに

Railsアプリケーションを開発していると、以下のようなエラーに遭遇することがあります：

TypeError - superclass mismatch for class AIRequest:
  app/models/ai_request.rb:1:in `<main>'
  app/views/documents/show.html.erb:7

このエラーは、クラス定義で名前の大文字・小文字や命名規則が原因で起こることが多いです。本記事では、このエラーの原因と解決策について解説します。

エラーの発生背景

Railsでは、モデル名がクラス名とファイル名の規約に従っている必要があります。この規約を無視してしまうと、Railsのオートローダーが正しくクラスを解釈できず、superclass mismatch for classエラーが発生します。

以下はエラーが発生した際のコード例です。

誤ったコード例

app/models/ai_request.rb

class AIRequest < ApplicationRecord 
  belongs_to :user, optional: true
  belongs_to :document, optional: true

  validates :input_text, presence: true
end

• モデル名は AIRequest としていますが、ファイル名は ai_request.rb。
• Railsのオートローダーは、クラス名とファイル名の対応が「スネークケース（snake_case）」に基づいているため、AIRequest を解釈できません。

原因

Railsでは、クラス名とファイル名の命名規則が以下のように対応しています：

クラス名（CamelCase）	ファイル名（snake_case）
User	user.rb
Document	document.rb
AiRequest	ai_request.rb

AIRequest のように、すべて大文字を含むクラス名を使用すると、Railsが正しい対応を見つけられなくなります。

解決策

1. クラス名を変更する

Railsの規約に合わせてクラス名を修正しましょう。

修正後のコード

class AiRequest < ApplicationRecord 
  belongs_to :user, optional: true
  belongs_to :document, optional: true

  validates :input_text, presence: true
end

• AIRequest を AiRequest に変更。
• クラス名がファイル名と一致するようになります。

2. テーブル名は変更不要

Railsはクラス名とテーブル名を自動的に関連付けます。例えば、クラス名がAiRequestであれば、Railsはテーブル名としてai_requestsを自動的に推測するので、マイグレーションファイルやデータベースの変更は不要です。

補足: AIやAPIなどの命名

もし、AIRequestやAPIRequestなどの命名をどうしても使いたい場合、以下のようにclass_nameオプションで明示的にモデルを指定することも可能です。

例: Documentモデルに関連付ける場合

class Document < ApplicationRecord
  has_many :ai_requests, class_name: 'AiRequest'
end

ただし、Railsの命名規約を尊重する方がシンプルでエラーが少なくなります。

---

まとめ

エラーの原因

• クラス名（AIRequest）とファイル名（ai_request.rb）の対応がRailsの命名規則に合っていなかった。

解決策

• クラス名をAiRequestに変更し、命名規則に従う。

ポイント

• Railsでは、クラス名はCamelCase、ファイル名はsnake_caseという規則を守る。
• 特殊なケースでどうしても命名規則を変更したい場合は、class_nameオプションで調整可能。