Rails 5.2项目基于Capistrano 3.4.1执行部署重启触发nil调用[]方法的跨服务器异常

第一步：解锁完整报错栈，跳出截断输出的误区 #

你现在--trace拿不到有效信息的核心原因是Capistrano默认开启了栈截断逻辑，遇到gem内部抛出的异常时，会自动截断跨gem的栈段，只保留项目自定义任务的栈，并不是栈真的不存在。
按以下操作强制输出全量栈：

• 执行部署命令时直接叠加调试参数，跳过截断：

  DEBUG=1 TRACE=1 cap production deploy:restart --trace
  

• 如果上述输出仍被截断，在项目根目录的Capfile末尾追加配置，取消栈过滤规则：

  # 关闭SSHKit的栈截断，输出全链路报错位置
  SSHKit.config.command_map.pretty_print_backtrace = false
  

  重新执行部署命令，即可直接定位到具体哪一行代码对nil值调用了[]方法。

第二步：针对单台服务器报错的定向环境对齐 #

同一份代码、同一份部署配置，仅服务器B重启时报错，绝大多数情况是两台服务器的配置差异导致的nil值，无需全量排查代码，逐点对齐以下差异即可：

• 对齐deploy用户的环境变量差异：
  分别在服务器A、B上用deploy用户登录，导出当前环境变量做diff对比：

  # 服务器A上执行
  su - deploy -c 'env' > /tmp/env_A.txt
  # 服务器B上执行
  su - deploy -c 'env' > /tmp/env_B.txt
  diff /tmp/env_A.txt /tmp/env_B.txt
  

  重点核对RAILS_ENV、PASSENGER_ROOT、RUBY_VERSION、GEM_HOME这类部署流程强依赖的变量，确认服务器B是否缺失对应变量值，导致代码读取时拿到nil。
• 对齐Passenger配置的权限与路径差异：
  你的日志中已经捕获到Passenger 6.0.8的输出，重启阶段的nil报错，很多时候是Capistrano的Passenger插件在读取版本、根路径配置时，因为服务器B上Passenger配置文件权限不足（比如deploy用户读不到Passenger的配置文件），拿到nil值后再调用[]方法触发异常。
  直接在服务器B上用deploy用户执行以下命令验证权限：

  passenger-config --root
  passenger-config --version
  

  如果命令返回权限不足，修正对应配置文件的访问权限即可。
• 对齐部署目录的文件权限：
  进入服务器B的项目共享目录/var/www/[项目名]/shared，和服务器A逐文件对比权限：重点检查.env、database.yml、puma.rb这类会被部署流程读取的配置文件，确认是否因为之前的权限调整，导致deploy用户没有读权限，读取返回nil。

第三步：临时快速定位的兜底调试方法 #

如果暂时无法解锁完整栈，可以在自定义部署任务中增加异常捕获hook，直接输出报错的上下文：
在lib/capistrano/tasks/目录下新建调试任务文件，写入以下代码：

# 全局捕获部署异常，输出具体出错位置
namespace :debug do
  task :capture_errors do
    on roles(fetch(:rollback_role)) do |host|
      error = $!
      if error.is_a?(SSHKit::Runner::ExecuteError)
        puts "===== 服务器 #{host.hostname} 报错详情 ====="
        puts "原始异常：#{error.cause.message}"
        puts "出错代码位置：#{error.cause.backtrace_locations.first}"
        exit 1
      end
    end
  end
end

# 把调试hook挂到部署失败的回调上
after 'deploy:failed', 'debug:capture_errors'

重新执行重启命令，触发报错时就会直接输出原始异常的具体代码行号，无需盲猜nil值来源。

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