Docker中基于rbenv安装Ruby>=2.5后执行rake test报错排查

这个问题我之前也碰到过，核心原因是rbenv的环境变量没有在容器启动的ENTRYPOINT进程中被正确加载。

你使用的launcher.gcr.io/google/ruby:latest镜像里，rbenv的配置通常是写在用户的shell初始化文件（比如~/.bashrc或~/.profile）里的，但Docker默认执行ENTRYPOINT时，用的是非登录、非交互式shell——这类shell不会自动加载初始化文件，导致rbenv管理的Ruby 2.5.7的路径没被加入到系统$PATH中，系统自然找不到ruby2.5这个可执行文件。

下面给你几个可行的解决方案：

方案1：用登录shell执行ENTRYPOINT命令 #

修改Dockerfile的最后一行，让bash以登录模式启动，这样会自动加载rbenv的配置：

ENTRYPOINT ["bash", "-lc", "bundle exec rake test"]

bash -lc参数会触发登录shell行为，自动读取~/.profile里的rbenv初始化脚本，把rbenv的shims目录加入$PATH，这样就能找到正确的Ruby版本了。

方案2：手动在Dockerfile中设置环境变量 #

直接在安装完Ruby后，把rbenv的shims和bin目录加到PATH环境变量里，这样不管用什么shell启动都能生效：

FROM launcher.gcr.io/google/ruby:latest
RUN rbenv install 2.5.7 && \
    rbenv rehash && \
    rbenv global 2.5.7
# 手动添加rbenv路径到系统环境变量
ENV PATH="/root/.rbenv/shims:/root/.rbenv/bin:${PATH}"
COPY ./ /my-app
WORKDIR /my-app
RUN gem install bundler && \
    bundle install
ENTRYPOINT ["bundle", "exec", "rake", "test"]

方案3：构建时验证Ruby环境 #

可以在Dockerfile中加入验证步骤，确保Ruby版本和路径正确，方便排查问题：

RUN ruby -v && which ruby

这一步会在docker build时输出当前Ruby版本和可执行文件路径，如果显示的是2.5.7且路径在/root/.rbenv/shims/ruby，说明环境配置正确。

另外你提到用RVM也遇到相同错误，原因和rbenv完全一致——RVM的环境变量也是依赖shell初始化文件加载，同样可以用上述两种方案解决。

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