Capistrano部署Rails应用遇认证失败及服务器IP显示异常求助

看起来你遇到了Capistrano缓存旧服务器IP导致的认证失败问题——这种情况我也碰到过几次，大概率是缓存残留或者配置没彻底更新导致的，咱们一步步来排查解决：

• 第一步：清理Capistrano本地缓存
  Capistrano会在本地项目的tmp/capistrano目录缓存部署元数据，旧IP很可能藏在这里。直接删掉这个目录最彻底：
  rm -rf ./tmp/capistrano
  也可以用Capistrano自带的清理命令：
  cap production deploy:cleanup

• 第二步：逐一核对核心配置文件
  仔细检查这几个关键文件，确保没有残留旧IP的配置：

  • Capfile：确认没有引入任何包含旧IP的自定义配置脚本，所有加载的插件都是正常的Rails部署相关插件。
  • deploy.rb：找到server定义行，确保IP是新的46.101.45.52，比如：

    server '46.101.45.52', user: 'deploy', roles: %w[app db web]
    

    同时检查有没有用环境变量或者其他方式间接指定服务器地址，比如set :server, ENV['OLD_SERVER_IP']这种隐藏的坑。
  • config/deploy/production.rb：这个stage配置文件里也可能单独定义了server，务必确认这里的IP也是新的，另外检查ssh_options有没有硬编码旧IP的情况。

• 第三步：验证本地SSH配置
  有时候本地~/.ssh/config里的服务器别名会覆盖Capistrano的配置。打开这个文件看看有没有类似这样的条目：

Host rails-production
  HostName 159.65.33.89
  User deploy

如果有，把HostName改成新IP46.101.45.52，或者直接删除这个条目。之后先手动测试SSH连接新服务器：
ssh deploy@46.101.45.52
确保能无密码正常登录，排除SSH密钥本身的问题。

• 第四步：更新Capistrano依赖
  旧版本的Capistrano偶尔会有缓存逻辑的bug，尝试更新到最新稳定版：
  在Gemfile里调整版本：

gem 'capistrano', '~> 3.17'
gem 'capistrano-rails', '~> 1.6'

然后执行：
bundle update capistrano capistrano-rails
更新完成后再尝试部署。

• 第五步：用详细日志定位问题
  如果上面的步骤都没解决，就开启详细部署日志，看看具体哪一步调用了旧IP：
  cap production deploy --trace
  从输出里你能看到每一步加载的配置和执行的命令，很容易找到旧IP的来源。

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