安装devise后执行db:migrate仍提示迁移待处理报错

问题表现 #

Rails项目安装devise gem后，即使执行过bin/rails db:migrate，仍持续触发报错，项目数据库为PostgreSQL。

• 页面固定提示：

Migrations are pending. To resolve this issue, run: bin/rails db:migrate RAILS_ENV=development

• 终端输出的核心错误：

PG::DuplicateColumn: ERROR: column "email" of relation "staffs" already exists
: ALTER TABLE "staffs" ADD "email" character varying DEFAULT '' NOT NULL

• 框架抛出错误的对应源码逻辑：

# Raises <tt>ActiveRecord::PendingMigrationError</tt> error if any migrations are pending.
def check_pending!(connection = Base.connection)
  raise ActiveRecord::PendingMigrationError if connection.migration_context.needs_migration?
end

def load_schema_if_pending!

故障原因 #

Devise生成Staff模型相关迁移时，默认会创建email字段用于身份认证，但当前staffs数据表中已经存在同名字段，导致该条ADD COLUMN语句执行失败。迁移执行中断后，ActiveRecord会持续检测到未完成的迁移记录，因此反复抛出待迁移提示，和是否重复执行migrate命令无关。

修复步骤 #

1. 定位Devise生成的Staff模型迁移文件，路径格式为db/migrate/[时间戳]_devise_create_staffs.rb
2. 编辑该迁移文件，删除或注释掉新增email字段的配置行，避免重复建字段：

## 注释掉默认生成的email字段添加逻辑
# t.string :email,              null: false, default: ""

3. 执行以下命令查看迁移状态，找到执行失败的Devise迁移对应的版本号：
   bin/rails db:migrate:status
4. 回滚失败的迁移记录，将命令中[版本号]替换为上一步查到的失败迁移版本数字：
   bin/rails db:migrate:down VERSION=[版本号]
5. 重新执行迁移命令：
   bin/rails db:migrate RAILS_ENV=development
6. 重启本地Rails服务即可恢复访问。

补充说明：如果原有email字段不符合Devise的使用要求（比如未加唯一索引、允许空值），需要单独编写新的迁移调整字段属性，不要直接修改已执行过的历史迁移文件。

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