Rails 7.0.4重建密钥失败求助：无法生成master.key及环境密钥

核心背景 #

Rails 7的环境凭据机制中，指定--environment=production时，会生成config/credentials/production.key（环境专属密钥）和config/credentials/production.yml.enc，而非依赖根目录的master.key。你遇到的问题大概率是编辑器未正确等待、目录权限或残留文件干扰导致的。

分步解决步骤 #

1. 彻底清理残留文件
   删除config/credentials/下所有文件，同时删除根目录的master.key（如果存在），确保无旧配置干扰：

   rm -rf config/credentials/*
   rm -f master.key
   

2. 确保编辑器正确等待
   执行凭据编辑命令时，必须保证编辑器能保持打开直到你手动关闭，否则Rails会跳过密钥生成。用VS Code的话，命令要带正确的--wait参数：

   EDITOR="code --wait" rails credentials:edit --environment=production
   

   打开编辑器后，随便输入一行内容（比如dummy: data），保存并关闭编辑器。此时应该生成production.key和production.yml.enc。

   如果VS Code还是不行，换用基础编辑器排查：

   EDITOR="nano" rails credentials:edit --environment=production
   

   输入内容后按Ctrl+O保存，Ctrl+X退出，再检查文件是否生成。

3. 修复目录权限
   确保config/credentials目录存在且有读写权限：

   mkdir -p config/credentials && chmod 755 config/credentials
   

   确保执行Rails命令的用户对该目录有写入权限，避免权限不足导致密钥无法生成。

4. 验证生成结果
   执行以下命令检查文件：

   ls config/credentials/
   

   正常情况下会看到production.key和production.yml.enc两个文件。

5. 环境变量配置（可选）
   若不想依赖本地production.key文件，可将文件内的密钥内容复制到环境变量：

   export RAILS_MASTER_KEY="替换为production.key中的密钥字符串"
   

   部署环境中可根据平台配置对应环境变量（如RAILS_PRODUCTION_KEY）。

常见坑点 #

• 不要只删除credentials.yml.enc，必须清空整个config/credentials目录。
• 编辑器必须支持--wait参数，否则Rails会误以为编辑已完成，跳过密钥生成。
• Rails 7的环境凭据密钥是环境专属的，不会自动填充RAILS_MASTER_KEY环境变量，需手动设置或依赖本地.key文件。

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