AWS SAM构建Ruby3.2镜像失败：返回错误码5

开发者阿泽

2026-6-13

AWS SAM构建Ruby3.2镜像时bundle install错误码5问题解析

错误码5的含义

bundle install返回的错误码5对应的是权限拒绝（Permission Denied），意味着执行该命令时，当前运行用户没有足够的权限去读写操作涉及的文件或目录，比如Gemfile所在目录、Ruby的gem安装目录等。

镜像构建阶段用户权限不足：SAM生成的Ruby3.2镜像模板默认会使用非root用户（比如ruby用户）执行构建步骤，但该用户可能没有权限写入系统级的gem安装目录（如/usr/local/bundle）。
解决办法：修改项目中的Dockerfile，在bundle install步骤前临时切换到root用户，执行完成后再切回原用户：
```
USER root
RUN bundle install
USER ruby
```
或者指定bundle将gem安装到当前用户有权限的目录：
```
RUN bundle install --path vendor/bundle
```
本地目录权限映射冲突：构建时Docker会将本地项目目录挂载到容器内，如果本地目录的权限设置过于严格（比如仅本地root用户可读写），容器内的非root用户无法访问或修改其中的文件（如Gemfile.lock）。
解决办法：调整本地项目目录的权限，比如赋予其他用户读写权限：
```
chmod -R o+rw ./your-project-dir
```
或者修改本地目录的所有者为与容器内用户匹配的UID/GID。
SAM构建上下文的权限问题：如果自定义了SAM的构建上下文配置，可能包含了一些权限受限的文件或目录，导致容器内构建过程无法正常访问。
解决办法：检查samconfig.toml或构建命令中的上下文设置，排除不必要的权限敏感文件。