Django-Nginx-Gunicorn部署环境下502 Bad Gateway错误及Gunicorn启动失败问题求助

环境与背景 #

• 服务器环境：nginx/1.18.0 (Ubuntu)
• 部署架构：Django-Nginx-Gunicorn
• 触发场景：删除clinicsite文件恢复后，重启Gunicorn和Nginx出现502错误，Gunicorn提示Failed to start gunicorn daemon.

核心错误定位 #

运行manage.py时抛出的错误是关键突破口：

ModuleNotFoundError: No module named 'dj_database_url'

同时注意到错误日志里的Django路径指向系统全局Python环境（/usr/local/lib/python3.8/dist-packages/django），但你的Gunicorn配置明确使用了虚拟环境/root/myprojectdir/myprojectenv/bin/gunicorn——这说明虚拟环境中缺失dj_database_url依赖包，导致Gunicorn启动时无法加载Django项目配置，进而引发启动失败和Nginx的502错误。

分步解决步骤 #

1. 激活虚拟环境并补全依赖

先进入项目目录，激活指定的虚拟环境，安装缺失的依赖包：

cd /root/myprojectdir
source myprojectenv/bin/activate
pip install dj_database_url

安装完成后，用虚拟环境的Python验证项目是否能正常加载：

python manage.py check

如果没有报错，说明依赖问题已解决。

2. 修复Gunicorn启动问题

查看Gunicorn的详细启动日志，确认是否还有其他阻碍：

journalctl -u gunicorn.service -f

若日志中不再出现模块缺失错误，尝试重启Gunicorn服务：

systemctl restart gunicorn.service
systemctl status gunicorn.service

确认服务状态变为active (running)。

3. 验证Socket文件权限

Gunicorn配置中绑定的是unix:/run/gunicorn.sock，需要确保Nginx运行用户www-data有访问该socket的权限：

ls -l /run/gunicorn.sock

如果权限不符合要求，可修改gunicorn.service文件中的用户组配置：

[Service]
User=root
Group=www-data  # 将原来的sudo改为www-data
# 其他配置保持不变

修改后重载配置并重启Gunicorn：

systemctl daemon-reload
systemctl restart gunicorn.service

4. 重启Nginx并验证服务

最后重启Nginx，访问项目检查是否恢复正常：

systemctl restart nginx.service
curl http://你的服务器IP

额外排查方向（若以上步骤未解决） #

• 确认clinicsite/settings.py中SETTINGS_MODULE配置无路径错误
• 检查项目目录权限，确保Gunicorn运行用户root能读取所有项目文件
• 查看Nginx错误日志/var/log/nginx/error.log，是否存在socket连接失败的提示

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