AWS CLI s3 cp --recursive控制台正常但.sh脚本中报Unknown options错误
脚本执行时--recursive参数被AWS CLI识别为未知选项的问题定位
常见触发原因
1. 行尾格式排查的逻辑偏差
你此前判定脚本无Windows行尾格式问题的依据存在漏洞:
- 其他命令可正常运行,仅能证明脚本大部分行的行尾为标准LF格式,无法排除
aws s3 cp所在行单独携带CRLF不可见字符的情况 - 当
--recursive是该行最后一个参数时,附着在参数后的Windows回车符\r会被shell视为参数内容的一部分,最终传入AWS CLI的实际参数为带控制字符的--recursive\r,而非标准的--recursive选项,自然会被判定为未知参数 - 移除
--recursive后命令可正常完成单文件传输,正是该场景的典型特征:移除递归参数后,该行最后一个参数变为本地目标路径/home/ec2-user/,附着在路径后的\r对AWS CLI的目录解析逻辑容错性更高,只要目标目录存在,就会忽略末尾控制字符完成单文件传输,很容易让人误以为行尾问题已经被完全排除。
2. 非交互shell的环境变量差异
- 交互式控制台执行命令时,会加载
~/.bashrc、~/.bash_profile中定义的完整环境变量,PATH路径指向你验证过的aws-cli/2.1.15安装路径 - 直接运行.sh脚本属于非交互非登录shell,不会加载上述配置的部分环境变量,可能优先匹配到其他路径下不支持
--recursive参数的同名aws可执行文件(比如系统预装的旧版工具、其他脚本定义的同名临时命令),而非你在控制台查询到的正确版本。
排查与修复步骤
- 检查脚本不可见字符:执行
cat -A your_script.sh查看脚本逐行内容,带CRLF的行末尾会显示^M$,正常LF行末尾仅显示$。如果aws s3 cp所在行存在^M标记,直接执行sed -i 's/\r$//' your_script.sh批量清除所有行的末尾回车符即可。 - 校验脚本环境下的AWS CLI信息:在脚本开头临时加入
which aws、aws --version两行调试命令,运行脚本后将输出与交互式控制台的查询结果对比。如果两者的可执行路径、版本号不一致,要么在脚本开头将正确的AWS CLI安装路径添加到PATH优先级最前端,要么直接用绝对路径调用AWS CLI,例如将命令写为/usr/local/bin/aws s3 cp s3://bucket/folder/ /home/ec2-user/ --recursive。 - 等价方案规避:如果确认是参数解析层的不可见字符问题,可以将递归下载命令替换为功能完全一致的
sync命令:aws s3 sync s3://bucket/folder/ /home/ec2-user/,该命令默认会同步路径下所有层级的文件,不需要额外添加递归参数,可规避长参数被不可见字符污染导致的解析错误。
内容的提问来源于stack exchange,提问作者WolVes
相关产品推荐
相关产品推荐

