无Rails的ActiveRecord 6多数据库连接配置报错求助

以下是几个常见的问题点及解决方式：

1. 环境变量未正确设置为test #

RSpec运行时，ActiveRecord会根据ENV['RAILS_ENV']或ENV['RACK_ENV']的值加载对应环境的配置。如果这两个变量没设为test，ActiveRecord默认会用development环境，此时找不到testdb的development配置，就会抛出错误。

解决方式：
在启动RSpec时指定环境变量，或者在spec_helper.rb开头设置：

ENV['RACK_ENV'] = 'test' # 非Rails环境用这个
# 或者
ENV['RAILS_ENV'] = 'test'

2. 配置结构不符合ActiveRecord 6要求 #

非Rails环境下，使用ActiveRecord::DatabaseConfigurations构建多数据库配置时，必须确保每个配置项的name（数据库标识）、environment（环境）、adapter等核心参数正确关联。如果配置结构错误，ActiveRecord无法识别test环境下的testdb配置。

正确配置示例：

configs = ActiveRecord::DatabaseConfigurations.new([
  {
    name: 'testdb',
    environment: 'test',
    adapter: 'postgresql', # 必须指定正确的适配器
    database: 'my_test_db',
    host: 'localhost',
    username: 'test_user',
    password: 'test_pass'
  }
])

# 必须将配置赋值给ActiveRecord::Base.configurations
ActiveRecord::Base.configurations = configs

3. 模型未指定对应数据库连接 #

多数据库场景下，每个模型需要明确指定使用的数据库连接池，否则会默认使用主数据库配置。如果模型没有关联到testdb，就会找不到对应环境的配置。

解决方式：
在模型类中添加连接指定：

class MyTestModel < ActiveRecord::Base
  establish_connection :testdb # 这里的名称要和配置中的name一致
end

4. 配置加载时机过晚 #

如果在模型加载完成后才初始化ActiveRecord配置，模型会在加载时尝试读取未初始化的配置，导致报错。必须确保配置初始化在模型加载之前完成。

正确顺序（spec_helper.rb中）：

require 'active_record'

# 1. 设置环境变量
ENV['RACK_ENV'] = 'test'

# 2. 构建并加载数据库配置
configs = ActiveRecord::DatabaseConfigurations.new([
  {
    name: 'testdb',
    environment: 'test',
    adapter: 'sqlite3',
    database: ':memory:'
  }
])
ActiveRecord::Base.configurations = configs

# 3. 初始化连接（可选，若模型已单独指定则可跳过）
ActiveRecord::Base.establish_connection(:testdb)

# 4. 加载模型
require_relative '../app/models/my_test_model'

# 其他RSpec配置
RSpec.configure do |config|
  # ...
end

5. 配置缺失adapter参数或拼写错误 #

AdapterNotSpecified错误最常见的原因之一就是配置中缺少adapter参数，或者适配器名称拼写错误（比如把postgresql写成postgres，mysql2写成mysql）。此时错误信息可能会误导你认为数据库未配置，但实际是适配器未指定。

检查点：
确保test环境下的testdb配置中包含正确的adapter字段，比如：

adapter: 'sqlite3' # 或 postgresql/mysql2等

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