如何访问AWS Batch作业自定义环境变量？配置后读取报KeyError

首先明确：你用os.environ['PROC_ENV']读取环境变量的写法是完全正确的，这是Python读取进程环境变量的标准方式，问题出在配置或作业提交环节，常见遗漏点如下：

• 作业提交时的环境变量覆盖逻辑没注意：作业定义里配置的Environment是默认值，如果你提交作业时（不管是控制台手动提交、SDK/API调用、还是通过其他服务触发提交）传了containerOverrides.environment参数，这个参数会全量替换作业定义里的环境变量配置，而非增量合并。只要提交作业时写了任意环境变量覆盖规则，却没在覆盖列表里显式带上PROC_ENV=dev，作业定义里配的这个变量就不会被注入到运行容器中。
• 作业定义修订版本不匹配：CloudFormation更新作业定义资源时会生成新的修订版本，如果你提交作业时手动选择了旧的、未配置该环境变量的修订版，或者触发作业的配置里硬编码了旧版本号，运行的作业自然不会加载你新配的变量。
• 容器启动逻辑清空了环境变量：如果你的自定义镜像的ENTRYPOINT/CMD启动脚本里用了env -i之类的清空环境变量的命令，会把AWS Batch默认注入的所有环境变量（包括你自定义的）全部清除，这种情况也会读不到目标变量。
• 配置项带隐藏字符：如果配置Name字段时是从其他地方复制粘贴的，可能带入了零宽空格、换行符等不可见字符，控制台视觉上看是PROC_ENV，实际变量名和代码里写的不一致，也会触发KeyError。

快速排查方法 #

在Python代码最开头加两行打印，先把容器内实际加载的所有环境变量输出到作业日志里，直接定位问题：

import os
# 打印所有环境变量，核对目标变量是否存在、名称是否完全匹配
for k, v in sorted(os.environ.items()):
    print(f"{k}={v}")

如果打印结果里完全找不到PROC_ENV，按前面列的几个点依次核对即可；如果能找到这个变量，看变量名是不是带了多余的隐藏字符，调整代码里的key和实际变量名完全一致就能正常读取。

内容的提问来源于stack exchange，提问作者J.Hammond