Rails 6下如何无停机为活跃写入的现有表添加主键？

明确说：完全可以不新建表搞定，核心是分阶段兼容Rails的主键逻辑和数据库变更，避免部署前后代码与schema冲突。

阶段1：先部署代码兼容层 #

你之前踩的坑是self.primary_key = nil，这会让ActiveRecord生成空的主键列名，导致Unknown column 'tablename.'错误。换下面的写法，让代码同时兼容「无主键」和「有主键」的状态：

• 保留self.primary_key = :id（哪怕当前表还没这个列，先给Rails一个明确的主键逻辑）
• 加上self.ignored_columns = [:id]暂时忽略这个不存在的列
• 所有查询、更新操作手动指定业务唯一标识作为条件，别依赖主键（比如用业务唯一字段替代id做where条件）

示例模型代码：

class YourModel < ApplicationRecord
  self.table_name = 'tablename'
  self.primary_key = :id
  self.ignored_columns = [:id]

  # 封装安全的更新方法，避免依赖主键
  def safe_update!(attributes)
    self.class.where(your_unique_biz_column: self.your_unique_biz_column).update!(attributes)
    reload # 刷新实例属性
  end
end

阶段2：无停机执行数据库变更（MySQL环境） #

分三步走，避免锁表影响活跃写入：

1. 先加允许为空的id列（直接加非空主键会锁全表）：

   ALTER TABLE tablename ADD COLUMN id BIGINT UNSIGNED NULL;
   

2. 小批量填充id的唯一值（每次1000行，重复到所有行都填充完）：

   SET @row = 0;
   UPDATE tablename SET id = (@row := @row + 1) WHERE id IS NULL LIMIT 1000;
   

3. 把id改成自增主键（MySQL 8.0+支持在线执行，低版本选低峰期操作）：

   ALTER TABLE tablename MODIFY COLUMN id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY;
   

阶段3：部署代码收尾 #

数据库变更完成后，更新模型代码：

• 移除self.ignored_columns = [:id]
• 可以保留self.primary_key = :id（或者直接删掉，Rails默认主键就是id）
• 恢复正常的ActiveRecord操作（比如直接用instance.update!）

关键注意点 #

• 必须按「代码兼容层→数据库变更→代码收尾」的顺序部署，确保部署前后服务都能跑
• 全程依赖业务唯一标识列，用来替代主键做查询、更新条件
• 批量填充id时一定要小批次，避免长时间锁表影响写入
• 测试环境要模拟生产的活跃写入场景，验证每个阶段的兼容性

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