Python函数无法读取调用脚本全局变量触发KeyError的解决方法

你遇到的KeyError本质是对Python的globals()作用域的认知偏差：Python中globals()返回的是当前函数所属模块的全局命名空间字典，而非跨整个项目的全局作用域。
你在file_helper.py里写的globals()[i + '_null_exception_code']，只会去查file_helper.py自身模块顶层定义的变量，完全不会访问adhoc_job.py里定义的test_col_null_exception_code这类变量——Python模块本身是独立隔离的命名空间，不存在跨模块自动读取对方全局变量的机制，自然会触发键不存在的报错。

下面几种方案按工程上的推荐优先级排序：

方案1：通过参数显式传递配置（最高推荐） #

彻底去掉隐式的全局变量查找逻辑，把需要的异常码作为结构化参数传给函数，这是符合Python开发规范、耦合度最低的实现方式：

1. 改造file_helper.py中的函数，新增接收异常码映射的参数：

   def null_cols_exception(df, cols_to_check, excpt_code_map):
       """
       :param df: 待校验的数据框
       :param cols_to_check: 需要校验非空的列名列表
       :param excpt_code_map: 列名对应非空异常码的映射字典，示例结构: {"test_col":123, "test_col2":999}
       """
       for col in cols_to_check:
           # 增加配置校验，避免运行时隐式报错
           if col not in excpt_code_map:
               raise KeyError(f"列 {col} 未配置对应的非空异常码")
           excpt_cd = excpt_code_map[col]
           print(excpt_cd)
   

2. 改造adhoc_job.py中的调用逻辑，把原来零散定义的异常码变量整理为映射字典传入函数：

   from helper.file_helper import null_cols_exception
   
   # 列名与异常码的对应关系
   excpt_code_map = {
       "test_col": 123,
       "test_col2": 999
   }
   null_cols = ['test_col', 'test_col2']
   
   # 调用时传入映射参数
   null_df = null_cols_exception(test_df, null_cols, excpt_code_map)
   

这种写法没有任何隐式的依赖关系，函数逻辑可独立测试，后续调整异常码配置时不需要修改函数本身的代码。

方案2：抽离公共常量到独立配置模块 #

如果这些异常码是项目内多个模块通用的固定配置，可以在项目公共目录下新建独立的常量配置模块，所有模块统一从该模块导入常量，避免重复定义：

1. 新建base_dir/constants.py，统一维护所有配置：

   # 非空校验异常码定义
   TEST_COL_NULL_EXCEPTION_CODE = 123
   TEST_COL2_NULL_EXCEPTION_CODE = 999
   
   # 提前预定义列名与异常码的映射关系
   COLUMN_NULL_EXCEPTION_MAP = {
       "test_col": TEST_COL_NULL_EXCEPTION_CODE,
       "test_col2": TEST_COL2_NULL_EXCEPTION_CODE
   }
   

2. file_helper.py中的函数直接从配置模块导入需要的映射即可，不需要再通过globals()动态查找变量。

方案3（不推荐）：显式传递调用方的全局命名空间 #

如果短期内不想改动现有函数的参数逻辑，也可以把调用方的全局命名空间显式传给被调用的函数，但这种写法会让代码依赖关系变得隐蔽，后续维护难度高，仅作为临时过渡方案使用：

1. 修改file_helper.py的函数定义：

   def null_cols_exception(df, cols_to_check, caller_globals):
       for col in cols_to_check:
           excpt_cd = caller_globals[f"{col}_null_exception_code"]
           print(excpt_cd)
   

2. 调用时传入当前模块的globals()：

   null_df = null_cols_exception(test_df, null_cols, globals())
   

注意：这种写法本质是打破了模块的命名空间隔离，后续如果出现同名全局变量，很容易引发难以排查的逻辑错误，生产环境的代码不建议使用。

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