使用环境变量执行AWS SecretsManager CLI命令报错排查

问题场景 #

执行AWS CLI命令时，通过环境变量$test_env_variable指定--secret-id参数触发报错，但传入硬编码值可正常运行。

执行的命令：

aws secretsmanager get-secret-value --secret-id $test_env_variable --query "SecretString"

报错信息：

使用方法: aws [选项] <命令> <子命令> [<子命令> ...] [参数]
如需查看帮助文本，可执行：
aws help
aws <命令> help
aws <命令> <子命令> help
aws.exe: 错误: 参数 --secret-id: 需要一个参数

解决方法 #

• 检查环境变量的有效性
  先确认环境变量test_env_variable已经正确赋值且生效：

  # 类Unix系统（Linux/macOS）查看变量值
  echo $test_env_variable
  # 如果为空，重新设置并导出
  export test_env_variable="你的Secret ID"
  
  # Windows cmd环境
  echo %test_env_variable%
  set test_env_variable=你的Secret ID
  
  # Windows PowerShell环境
  echo $env:test_env_variable
  $env:test_env_variable="你的Secret ID"
  

• 给环境变量加双引号包裹
  如果环境变量的值包含空格、特殊字符（比如&、*），直接使用$test_env_variable会被Shell拆分，导致--secret-id没有拿到完整参数。改成如下命令：

  aws secretsmanager get-secret-value --secret-id "$test_env_variable" --query "SecretString"
  

• 匹配操作系统的环境变量语法
  不同系统的环境变量引用语法不一样，别搞混了：

  • 类Unix系统用$变量名
  • Windows cmd用%变量名%
  • Windows PowerShell用$env:变量名
    要是你在Windows环境下用了$test_env_variable，系统根本识别不了这个变量，自然会报错。

内容的提问来源于stack exchange，提问作者Ammar Hassan