Rails新项目复用现有PostgreSQL数据库时出现Relation不存在错误

问题原因拆解 #

你碰到的Relation categories does not exist错误，本质是新项目和旧数据库的衔接没做好——要么是连接配置没对上，要么是模型关联没定义对，要么是测试环境用了空库。毕竟Rails不会自动识别外部数据库的结构和关联，得手动对齐。

复用数据库的核心注意事项 #

1. 数据库连接必须精准配置 #

新项目的config/database.yml里，开发、测试所有环境的配置都要和旧项目完全一致，别写错数据库名、用户名、密码：

development:
  adapter: postgresql
  database: 旧项目的数据库名
  username: 你的数据库用户名
  password: 对应密码
  host: localhost # 或者你的数据库主机地址
  port: 5432

test:
  adapter: postgresql
  database: 旧项目的数据库名 # 要是想单独用测试库，得先把旧库的结构导进去
  username: 同上
  password: 同上
  host: localhost
  port: 5432

如果测试环境用独立数据库，用pg_dump导出旧库结构，再导入到测试库即可。

2. 必须重新定义模型与关联 #

Rails不会从数据库自动读取关联关系，所以新项目里得重新创建模型文件，把多对多关联写清楚：

• app/models/article.rb：

class Article < ApplicationRecord
  has_and_belongs_to_many :categories
end

• app/models/category.rb：

class Category < ApplicationRecord
  has_and_belongs_to_many :articles
end

注意：多对多中间表的命名要符合Rails约定——两个模型复数名按字母排序，比如articles_categories。如果旧项目的中间表名不按这个规则来，得在关联里指定表名：

# 比如中间表叫category_articles
has_and_belongs_to_many :categories, join_table: 'category_articles'

3. 测试环境不能用空库 #

别让Rails自动生成空的测试数据库，得确保测试库有完整的表结构：

• 把旧项目的schema.rb复制到新项目，然后运行rails db:schema:load RAILS_ENV=test，把结构加载到测试库。
• 测试前先打开测试环境控制台（rails c test），手动查询Category.first，能读到数据再跑测试，先排除连接问题。

4. 数据库权限要到位 #

确保新项目用的数据库用户对旧数据库有读写权限，尤其是测试环境的用户，别因为权限不足读不到表。

快速排查步骤 #

1. 先核对config/database.yml的测试环境配置，确认数据库名正确，然后运行rails db:test:prepare同步结构。
2. 在测试控制台执行ActiveRecord::Base.connection.tables，看列表里有没有categories，没有的话就是测试库没同步结构。
3. 检查模型文件的关联代码，表名、方法名别写错大小写（Rails默认小写复数表名）。

内容的提问来源于stack exchange，提问作者Mr.DevEng