EC2部署Django应用时UWSGI与Python路径配置错误排查求助

问题描述 #

我正在AWS EC2上部署Django应用，按照教程操作后，在连接uWSGI与Django应用时遇到问题。

执行的命令：

(unifolio-back) ubuntu@ip-172-31-37-172:~$ which python
/home/ubuntu/.local/share/virtualenvs/unifolio-back-_HCbnSkq/bin/python
(unifolio-back) ubuntu@ip-172-31-37-172:~$ uwsgi --http :8080 --home /home/ubuntu/.local/share/virtualenvs/unifolio-back-_HCbnSkq/bin/python --chdir /srv/unifolio-back/ -w mysite.wsgi

得到的报错信息：

*** Starting uWSGI 2.0.19.1 (64bit) on [Sat Dec 19 09:54:26 2020] ***
compiled with version: 7.5.0 on 19 December 2020 01:14:28
os: Linux-5.4.0-1029-aws #30~18.04.1-Ubuntu SMP Tue Oct 20 11:09:25 UTC 2020
nodename: ip-172-31-37-172
machine: x86_64
clock source: unix
detected number of CPU cores: 1
current working directory: /home/ubuntu
detected binary path: /home/ubuntu/.local/share/virtualenvs/unifolio-back-_HCbnSkq/bin/uwsgi
!!! no internal routing support, rebuild with pcre support !!!
chdir() to /srv/unifolio-back/
*** WARNING: you are running uWSGI without its master process manager ***
your processes number limit is 3802
your memory page size is 4096 bytes
detected max file descriptor number: 1024
lock engine: pthread robust mutexes
thunder lock: disabled (you can enable it with --thunder-lock)
uWSGI http bound on :8080 fd 4
spawned uWSGI http 1 (pid: 2408)
uwsgi socket 0 bound to TCP address 127.0.0.1:40925 (port auto-assigned) fd 3
Python version: 3.6.9 (default, Oct 8 2020, 12:12:24) [GCC 8.4.0]
!!! Python Home is not a directory: /home/ubuntu/.local/share/virtualenvs/unifolio-back-_HCbnSkq/bin/python !!!
Set PythonHome to /home/ubuntu/.local/share/virtualenvs/unifolio-back-_HCbnSkq/bin/python
Fatal Python error: Py_Initialize: Unable to get the locale encoding
ModuleNotFoundError: No module named 'encodings'
Current thread 0x00007f54d0d2a600 (most recent call first):
Aborted (core dumped)

我猜测是Python路径配置有问题，但不知道如何解决，请问问题出在哪里？

问题分析与解决方法 #

我刚帮你排查了这个问题，核心原因非常明确：

1. 错误根源 #

你在uWSGI命令中使用的--home参数传错了路径！这个参数要求传入的是虚拟环境的根目录，但你却传给它Python可执行文件的路径（/home/ubuntu/.local/share/virtualenvs/unifolio-back-_HCbnSkq/bin/python）。uWSGI找不到正确的Python环境目录，自然无法加载Python核心模块（比如报错里提到的encodings），直接导致初始化失败。

2. 修复步骤 #

• 首先确认你的虚拟环境根目录：从which python的输出可以看出，虚拟环境的根目录是/home/ubuntu/.local/share/virtualenvs/unifolio-back-_HCbnSkq（因为python二进制文件在这个目录的bin子文件夹下）。
• 修改uWSGI命令，将--home参数替换为虚拟环境的根目录：

  uwsgi --http :8080 --home /home/ubuntu/.local/share/virtualenvs/unifolio-back-_HCbnSkq --chdir /srv/unifolio-back/ -w mysite.wsgi
  

3. 可选优化 #

你也可以用--virtualenv参数代替--home，语义更直观，效果完全一致：

uwsgi --http :8080 --virtualenv /home/ubuntu/.local/share/virtualenvs/unifolio-back-_HCbnSkq --chdir /srv/unifolio-back/ -w mysite.wsgi

额外提示 #

如果你的终端已经激活了虚拟环境（命令行开头有(unifolio-back)标识），其实可以不用指定--home或--virtualenv参数，uWSGI会自动使用当前激活的虚拟环境的Python解释器，命令可以简化为：

uwsgi --http :8080 --chdir /srv/unifolio-back/ -w mysite.wsgi

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