在Python脚本中使用os.environ无法读取Jenkins环境变量怎么办

• 确认变量作用域与执行上下文
  Jenkinsfile中定义的环境变量仅在声明的作用域内生效：全局environment块声明的变量全流水线可访问，withEnv块内的临时变量仅在块内生效，Python脚本必须放在变量生效的上下文内执行。如果流水线使用了多个不同的agent，环境变量不会跨agent传递，设置变量和运行Python的步骤需要放在同一个agent下。
• 避免使用隔离进程的命令执行Python
  运行Python脚本时不要使用新开独立会话的命令：Windows下不要用start启动Python，Linux下不要用nohup、setsid等脱离当前shell环境的命令，否则新进程不会继承Jenkins的环境变量。如果变量为Jenkins标记的敏感变量（凭证类变量），默认不会自动传递到子进程，需要显式配置允许传递该变量。
• 显式传递变量到执行环境
  可以在执行Python的命令前手动把变量赋值到当前shell环境，确保Python可以继承：
  Windows bat步骤示例：

  set SVN_BRANCH=%SVN_BRANCH%
  python c:\jenkins\workspace\test_jenkins_build.py
  

  Linux sh步骤示例：

  SVN_BRANCH=$SVN_BRANCH python test_jenkins_build.py
  

• Python侧增加排查与兼容逻辑
  可以先在Python脚本开头打印全部环境变量，确认变量是否传递成功、变量名是否有大小写拼写错误，同时使用更安全的读取方式避免直接抛出KeyError：

  import os
  # 打印所有环境变量排查问题
  for key, value in os.environ.items():
      print(f"环境变量：{key} = {value}")
  
  # 安全读取变量
  svn_branch = os.getenv("SVN_BRANCH")
  if not svn_branch:
      raise ValueError("未获取到SVN_BRANCH环境变量，请检查Jenkins传递配置")
  

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