数据库适配

这一课你将能做到

1. 用 database.yml 配置三套环境，并把敏感信息挪到环境变量
2. 把应用从 SQLite 切换到 MySQL/PostgreSQL，理解适配器差异
3. 配置连接池、读写分离与多数据库，说清楚各自的适用场景

为什么要学

Rails 默认用 SQLite 起步，零配置很爽，但真实项目几乎必然上 MySQL 或 PostgreSQL（本站就是 MySQL）。数据库适配层的知识决定了你能否顺利完成「本地开发 → 团队 staging → 生产」的迁移，也决定了流量翻倍时你的应用是平滑扩容还是半夜宕机。连接池配置错误是生产事故的高发区。

先建立图像

Rails 连接数据库的层次：

你的代码 Article.find(1)
      │
      ▼
Active Record（生成 SQL）
      │
      ▼
适配器 Adapter（mysql2 / pg / sqlite3 gem）
      │
      ▼
连接池（pool: 5，复用 TCP 连接）
      │
      ▼
数据库服务器（MySQL 8 / PostgreSQL 16 / SQLite 文件）

三套环境各自独立：

环境	用途	数据
development	本地开发	真实感种子数据
test	跑测试	每次测试前清空，事务回滚
production	线上	真实用户数据

跟着做

步骤 1：读懂默认 database.yml

config/database.yml（SQLite 默认版）：

default: &default
  adapter: sqlite3
  pool: <%= ENV.fetch("RAILS_MAX_THREADS", 5) %>
  timeout: 5000

development:
  <<: *default
  database: storage/development.sqlite3

test:
  <<: *default
  database: storage/test.sqlite3

production:
  <<: *default
  database: storage/production.sqlite3

要点：default: &default 定义锚点，<<: *default 在各环境复用——DRY 的 YAML 技巧。pool 是连接池大小，<%= ENV.fetch(...) %> 说明 yml 里可以嵌 ERB 读环境变量。

步骤 2：切换到 MySQL

新项目直接指定：

rails new blog --database=mysql

已有项目改造——Gemfile 换驱动：

gem "mysql2", "~> 0.5"     # 删掉 sqlite3

config/database.yml：

default: &default
  adapter: mysql2
  encoding: utf8mb4
  pool: <%= ENV.fetch("RAILS_MAX_THREADS", 5) %>
  username: <%= ENV.fetch("DB_USERNAME", "root") %>
  password: <%= ENV.fetch("DB_PASSWORD", "") %>
  host: <%= ENV.fetch("DB_HOST", "localhost") %>

development:
  <<: *default
  database: blog_development

test:
  <<: *default
  database: blog_test

production:
  <<: *default
  database: blog_production