Rails模型继承出现‘superclass mismatch for class BankTransfer’错误的修复

问题场景 #

开发基于Rails单表继承（STI）的支付方式应用时，前端视图报错：superclass mismatch for class BankTransfer。相关操作及代码如下：

操作与现有代码 #

1. 用scaffold生成payment_methods的MVC：

rails g scaffold payment_methods type:string is_active:boolean

2. 模型文件payment_method.rb中定义继承关系：

class PaymentMethod < ApplicationRecord

end

class BankTransfer < PaymentMethod

end

class PayPal < PaymentMethod
end

3. Rails控制台操作正常：
   执行BankTransfer.create、PayPal.create可创建数据，PaymentMethod.all能查询到所有记录：

PaymentMethod.all
  PaymentMethod Load (0.2ms)  SELECT "payment_methods".* FROM "payment_methods"                                                                 
 =>                                                                  
[#<BankTransfer:0x00007f995d403000                                         
  id: 1,                                                             
  type: "BankTransfer",                                                    
  is_active: nil,                                                    
  created_at: Fri, 15 Jul 2022 16:46:29.759160000 UTC +00:00,         
  updated_at: Fri, 15 Jul 2022 16:46:29.759160000 UTC +00:00>,        
 #<PayPal:0x00007f995d402da8
  id: 2,
  type: "PayPal",
  is_active: nil,
  created_at: Fri, 15 Jul 2022 16:46:56.087921000 UTC +00:00,
  updated_at: Fri, 15 Jul 2022 16:46:56.087921000 UTC +00:00>] 

4. 自动生成的视图与控制器：

• index.html.erb：

<div id="payment_methods">
  <% @payment_methods.each do |payment_method| %>
    <%= render payment_method %>
    <p>
      <%= link_to "Show this payment method", payment_method %>
    </p>
  <% end %>
</div>

• payment_methods_controller.rb：

class PaymentMethodsController < ApplicationController
  before_action :set_payment_method, only: %i[ show edit update destroy ]

  def index
    @payment_methods = PaymentMethod.all
  end

  def show
  end

  def new
    @payment_method = PaymentMethod.new
  end

  (...)

  private
    def set_payment_method
      @payment_method = PaymentMethod.find(params[:id])
    end

    def payment_method_params
      params.require(:payment_method).permit(:type, :is_active)
    end
end

错误原因 #

Rails自动加载机制与STI规范冲突：将所有子类写在父类文件中时，请求过程中Rails会重复尝试加载子类，导致类的超类定义被重复识别，触发不匹配错误；同时Rails STI要求子类需放在单独文件中，否则会干扰自动加载逻辑。

修复步骤 #

1. 拆分模型文件 #

按Rails命名规范，为每个子类创建单独模型文件：

• 创建app/models/bank_transfer.rb：

class BankTransfer < PaymentMethod
end

• 创建app/models/pay_pal.rb（类名驼峰，文件名蛇形）：

class PayPal < PaymentMethod
end

修改app/models/payment_method.rb仅保留父类：

class PaymentMethod < ApplicationRecord
end

2. 调整视图渲染逻辑 #

当前<%= render payment_method %>会调用对应子类的局部视图，需补充或修改：

• 方案一：为每个子类创建局部视图
  • app/views/payment_methods/_bank_transfer.html.erb：

    <div class="payment-item">
      <p>类型：银行转账</p>
      <p>状态：<%= bank_transfer.is_active ? "已激活" : "未激活" %></p>
    </div>
    

  • app/views/payment_methods/_pay_pal.html.erb：

    <div class="payment-item">
      <p>类型：PayPal支付</p>
      <p>状态：<%= pay_pal.is_active ? "已激活" : "未激活" %></p>
    </div>
    

• 方案二：统一渲染通用属性，替换<%= render payment_method %>为：

  <div class="payment-item">
    <p>类型：<%= payment_method.type %></p>
    <p>状态：<%= payment_method.is_active ? "已激活" : "未激活" %></p>
  </div>
  

3. 重启Rails服务器 #

修改模型文件结构后，必须重启服务器，确保自动加载机制识别新的文件结构。

验证 #

重启服务器后访问/payment_methods，即可正常显示支付方式列表，错误提示消失。

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