Ubuntu Linode服务器下Gunicorn系统服务无法识别全局Python依赖问题

你手动执行命令时用的是自己的普通用户身份，若安装依赖时未加sudo，依赖会默认安装到当前用户家目录下的~/.local/lib/python3.9/site-packages路径中。而systemd配置中指定服务以www-data用户运行，该用户无权限读取你个人家目录下的依赖文件，因此会抛出ModuleNotFoundError。手动运行gunicorn正常，就是因为执行用户和安装依赖的用户一致，可以正常读取私有路径下的依赖包。

• 方案1：将依赖真正安装到全局公共路径
  执行以下命令重新安装所有项目依赖，确保所有用户都有权限读取：

  sudo pip3 install flask-login flask 【替换为你项目需要的其他依赖】
  

• 方案2：修改systemd服务的运行用户
  编辑/etc/systemd/system/testpad.service文件，将[Service]段下的User修改为你安装依赖时使用的普通用户名，Group可保留www-data保证Nginx能正常通信：

  [Service]
  User=【你的普通用户名】
  Group=www-data
  # 其余配置保持不变
  

• 方案3：显式指定Python依赖查找路径
  在[Service]段添加环境变量配置，指向你用户名下的依赖安装路径：

  [Service]
  # 其余配置保持不变
  Environment="PYTHONPATH=/home/【你的普通用户名】/.local/lib/python3.9/site-packages"
  

配置修改后生效步骤 #

1. 先删除之前启动失败残留的sock文件，避免绑定冲突：

   sudo rm /home/xxx/xxx/testpad.sock
   

2. 重载systemd配置：

   sudo systemctl daemon-reload
   

3. 重启服务验证：

   sudo systemctl restart testpad
   

你目前采用的后台绑定端口+Nginx转发的方案也可以正常使用，若要保证服务异常退出后自动重启，可配合supervisor、tmux或nohup+定时检测脚本使用即可。

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