RHEL7.9 Python3.6 venv安装Ansible 2.9.27报编码错误失败

根因 #

报错触发逻辑为当前Python/pip进程默认采用ASCII编码处理字符流，遇到非ASCII字符（报错中\xe9对应带尖音的拉丁字符é，常见于源码包贡献者姓名、版权元数据、含特殊字符的文件路径）时无法完成编码转换。RHEL 7.9最小化安装场景下，默认locale为C/POSIX、虚拟环境未继承系统UTF-8编码配置、安装路径含非ASCII字符是三个最高频触发点。

排查与修复步骤 #

• 校验当前会话编码配置
  执行locale命令查看输出，重点核对LANG、LC_ALL、LC_CTYPE三个字段值，若返回C或POSIX即为编码配置异常：
  1. 安装缺失的UTF-8 locale包（最小化安装默认不带该组件）：

     yum install -y glibc-langpack-en
     

  2. 当前会话设置UTF-8编码，注意激活虚拟环境后需要重新执行一次export，避免虚拟环境激活脚本覆盖编码配置：

     export LANG=en_US.UTF-8
     export LC_ALL=en_US.UTF-8
     source /path/to/your/a2.9.27/bin/activate
     pip install ansible==2.9.27
     

• 强制指定编码兜底
  若上述配置后仍报错，直接给Python进程指定IO编码，同时加--no-cache-dir参数跳过本地缓存，避免旧的损坏安装包干扰：

  PYTHONIOENCODING=utf-8 pip install ansible==2.9.27 --no-cache-dir
  

• 校验路径合规性
  检查虚拟环境存放路径、执行pip命令时的当前工作目录是否包含非ASCII字符（含中文、带变音符号的西文字符、全角特殊符号），若存在则将虚拟环境迁移到纯ASCII路径（如/opt/venv/a2.9.27）后再执行安装。

生效验证 #

配置完成后在已激活的虚拟环境中执行以下命令，返回utf-8即代表编码配置正常：

python -c "import sys; print(sys.getdefaultencoding())"

内容的提问来源于stack exchange，提问作者Steffen Winther Sørensen