树莓派3 Raspbian系统导入requests等包时出现OpenSSL相关UnicodeDecodeError

解决方案 #

步骤1：修复系统locale配置 #

该错误90%以上的概率是设备更换国家后系统默认字符集未适配导致，先执行命令验证当前字符集：
locale
如果输出中LC_*系列参数值不是*.UTF-8格式，执行以下命令重新配置locale：
sudo dpkg-reconfigure locales
在弹出的界面中勾选en_US.UTF-8并设为系统默认值，配置完成后执行source /etc/default/locale生效。

步骤2：临时强制Python启用UTF-8编码验证 #

执行以下命令测试是否能正常导入：
PYTHONUTF8=1 python3 -c "import requests"
如果命令无报错，将该环境变量设为永久生效，把export PYTHONUTF8=1添加到/etc/profile文件末尾，执行source /etc/profile生效。

步骤3：重装损坏的依赖包 #

如果前两步无效，说明cryptography/openssl相关的Python绑定包存在编译适配问题，执行以下命令重装：

sudo apt update && sudo apt reinstall -y openssl libssl-dev python3-pip
pip3 uninstall -y cryptography pyopenssl requests
pip3 install --no-binary :all: cryptography pyopenssl requests

如果不需要全局安装，可在第二条和第三条pip命令末尾添加--user参数避免修改系统Python环境。

内容的提问来源于stack exchange，提问作者Yorick De Bock