aws glue 工作流向作业传递参数时，必须以 `--key value` 格式显式声明（如 `--client value12`），才能通过 `getresolvedoptions()` 正确解析；否则即使参数值出现在 `sys.argv` 中，也会因缺少前缀而报“required”错误。
在 AWS Glue 中，getResolvedOptions() 函数仅识别以双连字符（--）开头的标准选项格式（即 --key value），它不会自动推断或匹配无前缀的裸值。从你提供的 sys.argv 输出可见：
'client', 'value12', '--JOB_NAME', 'test-job', ...
这里的 'client' 和 'value12' 是相邻的两个独立字符串，但缺少 -- 前缀，因此 getResolvedOptions(sys.argv, ['client']) 无法将其识别为 client 参数——它只查找形如 --client 的键，并期望其后紧跟对应值。
✅ 正确做法：
在 Glue 工作流配置中，为该 Glue 作业节点设置 Key-Value 形式的参数，且 Key 必须带 -- 前缀（系统会自动处理）：
| Key | Value |
|---|---|
| --client | value12 |
? 注意：在 AWS Console 或 CloudFormation/Terraform 中配置工作流参数时，直接填写 --client 作为键名（不是 client），值填 value12。Glue 运行时会将其注入为 ['--client', 'value12'] 到 sys.argv。
随后，在作业代码中即可安全解析：
import sys
from awsglue.job import Job
from awsglue.utils import getResolvedOptions
# 解析含 --client 的参数
args = getResolvedOptions(sys.argv, ['client', 'JOB_NAME', 'WORKFLOW_NAME'])
print(f"Client: {args['client']}") # 输出: value12
print(f"Job Name: {args['JOB_NAME']}") # 输出: test-job
print(f"Workflow: {args['WORKFLOW_NAME']}") # 输出: test-wf⚠️ 常见错误排查：
- ❌ 错误写法（工作流中设 Key=client）→ 导致 sys.argv 出现 'client', 'value12'，getResolvedOptions 找不到 --client；
- ❌ 混淆大小写（如 --Client vs ['client']）→ Glue 参数名严格区分大小写；
- ❌ 在 getResolvedOptions 中遗漏必填项（如 JOB_NAME）→ 即使未使用也需声明，否则抛出 KeyError 或 required 异常。
✅ 最佳实践建议：
- 所有自定义参数统一采用 --
命名（如 --source_bucket, --run_date）； - 在作业启动前，可先打印 sys.argv 辅助调试；
- 对关键参数做空值校验：
if not args.get('client'):
raise ValueError("Missing required parameter: --client")遵循此规范，即可稳定、可靠地在 Glue 作业中接收并使用工作流传递的上下文参数。
