Docker部署的Ruby on Rails 2.3应用无法加载lib及vendor目录文件

针对Docker容器中无法加载/lib目录文件和/vendor/gem_source里自定义gem的问题，结合Rails 2.3的特性和你的Dockerfile，给出以下排查和解决步骤：

1. 修正Rails加载路径配置 #

Rails 2.3里，config.autoload_paths不是控制文件加载的核心配置，你应该用config.load_paths来添加目录。修改environment.rb：

# 添加lib目录及其所有子目录
config.load_paths += ["#{RAILS_ROOT}/lib"]
config.load_paths += Dir["#{RAILS_ROOT}/lib/**/"]

# 添加vendor/gem_source下的所有自定义gem目录
config.load_paths += Dir["#{RAILS_ROOT}/vendor/gem_source/*"]

Rails 2默认会加载lib，但如果有嵌套子目录，必须手动添加进去才会被识别。

2. 确保Gemfile正确引用自定义gem #

Bundler不会自动识别vendor里的gem，必须在Gemfile里明确指定路径。如果是单个gem：

gem '你的自定义gem名称', :path => './vendor/gem_source/你的自定义gem名称'

如果有多个自定义gem，可以批量配置：

Dir["vendor/gem_source/*"].each do |gem_dir|
  next unless File.directory?(gem_dir)
  gem File.basename(gem_dir), :path => gem_dir
end

修改后重新构建Docker镜像，让Bundler安装这些本地gem。

3. 调整Dockerfile的构建逻辑 #

你的Dockerfile存在几个可能影响加载的问题：

• COPY顺序问题：先复制了vendor/gem_source，之后又执行COPY . .，如果本地目录的vendor内容有变动，会覆盖之前复制的文件。建议把COPY . .放在gem安装之后，确保本地vendor目录的内容是最终版本。
• bundle clean --force风险：这条命令会删除Gemfile里未声明的gem，如果你没在Gemfile里引用vendor的自定义gem，它们会被清理掉，直接删掉这条命令即可。
• 文件权限问题：COPY的文件默认是root用户所有，Rails进程如果用非root用户运行会没有读取权限。可以添加以下步骤：

# 创建非root用户并调整权限
RUN useradd -m appuser
RUN chown -R appuser:appuser /app
USER appuser

或者直接调整目录权限：

RUN chmod -R 755 /app/lib /app/vendor/gem_source

4. 验证加载路径是否生效 #

启动Rails控制台，执行以下命令查看加载路径：

puts $LOAD_PATH

如果输出里没有/app/lib或/app/vendor/gem_source/xxx，说明配置没生效，检查environment.rb是否在对应环境（development/production）中正确加载。

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