python network_error ai_generated true

django.db.utils.OperationalError: could not connect to server: Connection refused

ID: python/django-database-connection-timeout

Also available as: JSON · Markdown · 中文
80%Fix Rate
87%Confidence
0Evidence
2024-12-01First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
3.2 active — — —
4.0 active — — —
5.0 active — — —

Root Cause

数据库服务器未运行或网络不可达

generic

中文

Django 无法连接到配置的数据库服务器

Workarounds

  1. 90% success 检查数据库服务状态 
    systemctl status postgresql 或 service mysql status
  2. 95% success 验证数据库配置 
    检查 settings.py 中的 DATABASES 设置，确保主机、端口、用户名、密码正确

Dead Ends

Common approaches that don't work:

  1. 增加超时时间 70% fail

    如果数据库未运行，超时无法解决问题

  2. 修改数据库配置为本地连接 50% fail

    如果数据库在远程，本地连接无效