Amazon Linux中amazon-linux-extras调用random.py引发异常问题咨询

问题场景 #

在Amazon Linux的EC2实例或容器环境中，执行以下命令会触发异常：

echo "raise Exception()" > random.py
amazon-linux-extras

异常堆栈信息如下：

Traceback (most recent call last):
  File "/usr/lib64/python2.7/runpy.py", line 174, in _run_module_as_main
    "__main__", fname, loader, pkg_name)
  File "/usr/lib64/python2.7/runpy.py", line 72, in _run_code
    exec code in run_globals
  File "/usr/lib/python2.7/site-packages/amazon_linux_extras/__main__.py", line 23, in <module>
    from .cli import main as cli_main
  File "/usr/lib/python2.7/site-packages/amazon_linux_extras/cli.py", line 20, in <module>
    from .software_catalog import get_catalog, fetch_new_catalog, VERSION_KEY, CatalogError
  File "/usr/lib/python2.7/site-packages/amazon_linux_extras/software_catalog.py", line 26, in <module>
    from tempfile import gettempdir, NamedTemporaryFile
  File "/usr/lib64/python2.7/tempfile.py", line 35, in <module>
    from random import Random as _Random
  File "random.py", line 1, in <module>
    raise Exception()
Exception

该问题出现在GitLab CI中时，会导致整个构建流程崩溃。

原因解析 #

这不是amazon-linux-extras的特殊行为，而是Python模块导入机制的正常逻辑：

• Python导入模块时，会优先从当前工作目录查找同名文件，再去系统标准库路径搜索。
• amazon-linux-extras基于Python 2.7开发，执行过程中会导入标准库的tempfile模块，而tempfile又依赖标准库的random模块。
• 当当前目录存在random.py时，Python会加载本地的这个文件，而非系统标准库的random模块，从而触发文件中定义的异常。

解决办法 #

针对GitLab CI场景，可通过以下方式修复：

• 重命名或移除冲突文件：将本地的random.py改名为非标准库模块名的文件名，比如custom_random.py，避免命名冲突。
• 切换工作目录：执行amazon-linux-extras前切换到无冲突文件的目录，例如：

  cd /tmp && amazon-linux-extras
  

• 调整模块搜索优先级：临时设置PYTHONPATH环境变量，让系统标准库路径优先被搜索（不推荐，可能引发其他依赖问题）：

  PYTHONPATH=/usr/lib64/python2.7:$PYTHONPATH amazon-linux-extras
  

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