Ruby on Rails部署报错：ActiveSupport加密无效消息求助

核心原因 #

这个错误的本质是加密密钥不匹配——Rails项目的secret_key_base或加密相关环境变量在本地开发环境与服务器生产环境不一致，导致无法解密加密信息（如session、加密配置项），进而触发OpenSSL::Cipher::CipherError底层错误。

具体解决步骤 #

1. 核对服务器与本地的加密密钥 #

• 登录服务器，进入项目部署目录（例如/var/www/your_app/current）
• 检查服务器上的环境配置：
  • 若使用.env文件，确认.env.production中的SECRET_KEY_BASE与本地完全一致
  • 若使用Capistrano传递环境变量，确保config/deploy.rb或config/deploy/production.rb中正确设置：

    set :default_env, {
      'SECRET_KEY_BASE' => '本地生成的secret_key_base值'
    }
    

• 本地生成密钥的命令：rails secret，生成后同步到服务器

2. 处理Rails 5.2+的credentials配置 #

• 若项目使用credentials.yml.enc和master.key：
  • 确保服务器config目录下存在master.key，且内容与本地完全相同
  • 在Capfile中配置自动上传master.key到服务器的共享目录：

    set :linked_files, fetch(:linked_files, []).push('config/master.key')
    

  • 注意：master.key不可提交到Git，需通过安全方式同步到服务器

3. 验证OpenSSL版本兼容性 #

• 分别在本地和服务器执行openssl version，确认版本差异在兼容范围内（如均为1.1.x系列）
• 若服务器版本过低，执行升级命令：

  sudo apt update && sudo apt install openssl
  

4. 清理缓存并重新部署 #

• 清理服务器上的Rails临时文件与缓存：

  cd /var/www/your_app/current && bundle exec rails tmp:clear
  

• 重新执行部署命令：

  cap production deploy --trace
  

5. 检查Capistrano环境变量传递 #

• 在config/deploy/production.rb中确保环境变量传递正确：

  server '你的服务器IP', user: 'deploy', roles: %w[app db web]
  set :rails_env, 'production'
  set :default_env, {
    PATH: '$HOME/.rbenv/shims:$HOME/.rbenv/bin:$PATH',
    SECRET_KEY_BASE: ENV['SECRET_KEY_BASE']
  }
  

• 部署前确认本地环境变量已加载：执行echo $SECRET_KEY_BASE验证值是否正确

日志排查辅助 #

若问题仍未解决，查看capistrano.log中的报错细节：

若日志显示在decrypt步骤出错，可直接锁定为密钥不匹配；若报错发生在资产预编译阶段，大概率是credentials文件加载失败。

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