Rails挂载引擎创建评论时报SQLite3表不存在，表实际存在求排查方向

根据你在RubyMine中按照《Rails Engines Overview》指南操作时遇到的问题——创建评论时提示SQLite3::SQLException: no such table: main.articles，但实际blorgh_comments表存在，结合Ruby 2.5.0、Rails 5.1.5的环境特性，以下几个底层原因最可能触发这个问题：

1. 模型关联未指定正确的命名空间类 #

Rails引擎的模型默认处于引擎的命名空间下（比如Blorgh::Comment、Blorgh::Article），如果评论模型的关联没有显式指定所属的命名空间类，Rails会默认去查找主应用的articles表（而非引擎的blorgh_articles表），导致找不到表的错误。

排查与修复： #

检查app/models/blorgh/comment.rb中的关联代码，确保指定了正确的class_name：

class Blorgh::Comment < ApplicationRecord
  # 必须显式指定class_name，否则Rails会默认关联主应用的Article模型
  belongs_to :article, class_name: 'Blorgh::Article'
end

2. 引擎迁移未正确安装到Dummy应用 #

Rails引擎的迁移不会自动同步到dummy测试应用，需要手动安装迁移文件后再执行数据库迁移。如果跳过了这一步，dummy应用的数据库中可能缺少blorgh_articles表（评论依赖的关联表），从而触发错误。

排查与修复： #

在引擎根目录执行以下命令，确保迁移正确安装并执行：

# 将引擎的迁移文件复制到dummy应用
rails blorgh:install:migrations
# 进入dummy应用目录执行迁移
cd test/dummy
rails db:migrate

3. 引擎未配置表名前缀 #

Rails引擎通过表名前缀区分自身与主应用的数据库表（比如blorgh_前缀），如果引擎的初始化配置中未设置这个前缀，模型会默认使用不带前缀的表名（比如articles而非blorgh_articles），导致Rails查找错误的表。

排查与修复： #

检查引擎的初始化文件config/initializers/blorgh.rb，确保添加了表名前缀配置：

Blorgh::Engine.table_name_prefix = 'blorgh_'

4. Rails控制台的上下文错误 #

如果在引擎根目录直接启动rails console，控制台可能处于引擎的上下文而非dummy应用的上下文，此时模型无法正确加载dummy应用的数据库配置和命名空间映射，导致表查找错误。

排查与修复： #

进入dummy应用目录后再启动控制台：

cd test/dummy
rails console

在控制台中可以通过以下命令验证模型的表名是否正确：

puts Blorgh::Article.table_name # 应输出 "blorgh_articles"
puts Blorgh::Comment.table_name # 应输出 "blorgh_comments"

5. SQLite数据库连接路径错误 #

虽然你确认了test/dummy/db/development.sqlite3中存在表，但应用或控制台可能实际连接的是引擎根目录下的db/development.sqlite3（而非dummy应用的数据库），这个数据库中可能缺少所需的表。

排查与修复： #

在控制台中运行以下命令，确认当前连接的数据库路径：

puts ActiveRecord::Base.connection.database_url

如果输出不是test/dummy/db/development.sqlite3，需要检查dummy应用的config/database.yml配置，或确保启动控制台时处于dummy应用目录下。

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