Docker容器中Ruby on Rails项目启动报NoMethodError错误

问题根源 #

报错指向config.key?('UNICORN_PRELOAD')，说明当前代码里的config变量是字符串类型，而非预期的哈希/键值对象，导致无法调用哈希的key?方法。本地运行正常是因为本地环境中config被正确初始化为哈希，而Docker容器内的初始化流程出现异常。

排查与修复步骤 #

1. 确认config变量的实际类型与内容 #

在config/unicorn.rb第16行临时添加调试代码，重新启动容器查看输出：

p config.class # 输出变量类型
p config       # 输出变量具体内容

执行启动命令后，你会看到config是某个字符串（比如环境变量值、错误加载的文件内容等），而非预期的哈希对象。

2. 检查config变量的初始化逻辑 #

根据你的项目配置方式，针对性排查：

• 如果使用Figaro加载application.yml：
  确保在unicorn.rb开头正确加载配置：

  require 'figaro'
  Figaro.load
  config = Figaro.env # Figaro.env是支持key?方法的对象
  

  避免错误地将某个字符串环境变量赋值给config变量。
• 如果手动加载YAML文件：
  检查文件路径是否正确（Docker容器内的路径与本地可能不同），确保加载的是哈希：

  config_path = File.expand_path('../application.yml', __FILE__)
  config = YAML.load_file(config_path)[ENV['RAILS_ENV'] || 'production']
  

  注意：必须指定环境（如production），否则可能加载到整个YAML文件的字符串内容而非对应环境的哈希。

3. 修复第17行的安全调用 #

即使修复了初始化逻辑，也可以添加类型判断避免类似问题：

preload_app (config.is_a?(Hash) && config.key?('UNICORN_PRELOAD')) ? config['UNICORN_PRELOAD'].to_b : true

4. 核对依赖版本一致性 #

检查Docker容器内的Ruby版本、unicorn、figaro（若使用）等gem版本是否与本地一致。不同版本的gem可能导致配置加载逻辑的差异，可通过Gemfile.lock锁定版本，确保Docker环境安装相同版本的依赖。

关于切换基础镜像的说明 #

该错误与Debian/Alpine/CentOS基础镜像无直接关联，切换镜像后若问题解决，大概率是镜像内的依赖版本（如Ruby、gem）与本地不一致导致的配置加载异常，优先排查上述config变量的初始化问题更高效。

内容的提问来源于stack exchange，提问作者Alejandro Roble Gutiérrez