Gitlab-CI部署React项目至AWS S3失败求助

我之前也碰到过类似的情况——明明文件成功上传到S3了，但CI Job却因为exit code 2报错退出，大概率是命令细节、环境差异或者隐藏的警告导致的，咱们一步步来梳理排查方向：

1. 先确认命令的正确性 #

你提到本地执行命令正常，但CI里的命令写法aws s3 sync dist/'bucket-name' .看起来有点反常。正常的S3同步命令格式应该是：

aws s3 sync [本地源路径] s3://[桶名]

会不会是CI里的命令写错了参数顺序或者桶名的引用方式？比如不小心把桶名写到了本地路径里，或者目标路径写成了当前目录（.）？虽然你说文件上传成功，但可能是命令执行时的意外结果，这种逻辑错误很可能导致CLI返回非0退出码。先对比本地和CI里的命令是否完全一致，重点检查源路径、目标S3路径的格式和顺序。

2. 检查AWS CLI版本差异 #

本地和GitLab Runner环境的AWS CLI版本可能存在差异，部分旧版本的s3 sync命令在处理某些场景（比如文件元数据、符号链接）时，会返回非致命的exit code 2但实际同步完成。你可以在CI Job中添加一步打印版本：

aws --version

把这个版本和本地执行aws --version的结果对比，如果差异较大，尝试在CI里升级到和本地一致的版本，比如用pip指定版本安装：

pip install awscli==1.27.100  # 替换成你本地的版本号

3. 查看详细调试日志 #

AWS CLI的默认输出可能不会显示隐藏的警告或非致命错误，但这些会导致退出码异常。你可以在sync命令后加上--debug参数，让CLI输出详细日志：

aws s3 sync dist/ s3://your-bucket-name --debug

然后查看CI Job的完整日志，重点找带有ERROR或WARNING的条目，比如是否存在某个文件无法设置元数据、部分文件没有权限访问，或者桶的区域配置不一致等问题——这些细节很可能是导致exit code 2的根源。

4. 验证CI工作目录和文件状态 #

虽然文件上传成功，但还是要确认CI环境中的工作目录和dist文件夹状态是否和本地一致。在执行sync命令前添加以下步骤：

pwd  # 打印当前工作目录
ls -la dist/  # 查看dist文件夹的内容和权限

确保CI中的dist路径正确，文件权限正常，避免因为路径错误导致的部分文件同步异常。

5. 临时忽略退出码（权宜之计） #

如果确认所有必要文件都已成功同步，只是因为非致命警告导致的exit code 2，可以临时在命令后加上|| true来忽略退出码，让Job正常完成：

aws s3 sync dist/ s3://your-bucket-name || true

不过这只是临时解决方案，还是建议找到根本原因并修复，避免后续真的出现同步失败却被忽略的情况。

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