[Fixed]-Django – OperationalError: (2006, 'MySQL server has gone away')


The idea of the solution is clear: reconnect to mysql if the current connection is broken.

Please check this out:

def make_sure_mysql_usable():
    from django.db import connection, connections
    # mysql is lazily connected to in django.
    # connection.connection is None means
    # you have not connected to mysql before
    if connection.connection and not connection.is_usable():
        # destroy the default mysql connection
        # after this line, when you use ORM methods
        # django will reconnect to the default mysql
        del connections._connections.default


having the same issue.
I need idea how to check connection state for MySQLdb connection in django.
i guess it can be achieved by

catch OperationalError:

is anybody have a better idea?


my decision

if self.connection.errno()!=0:

check state of mysqldb connection if error recreate connection


you also need to serve case if connection is close

if self.connection.open:

refresh connection is just recreating it

    db_settings = settings.DATABASES['mysql_db']
        self.connection = MySQLdb.connect(host=db_settings['HOST'],port=int(db_settings['PORT']),db=db_settings['NAME'],user=db_settings['USER'],passwd=db_settings['PASSWORD'])
    except MySQLdb.OperationalError, e:
        self.connection = None


Since Django 1.6, you can use

import django.db


This does basically the same thing as adamsmith’s answer except that it handles multiple databases and also honors the CONN_MAX_AGE setting. Django calls close_old_connections() automatically before and after each request, so you normally don’t have to worry about it unless you have some long-running code outside of the normal request/response cycle.


The main reason that leads to this exception is mostly due to client ideal longer than wait_timeout on mysql server.

In order to prevent that kind of error, django supports an option named CONN_MAX_AGE which allow django to recreate new connection if old connections are ideal too long.
So you should make sure that CONN_MAX_AGE value is smaller than wait_timout value.

One important thing is that, django with wsgi handles checking CONN_MAX_AGE every requests by calling close_old_connections. So you mainly don’t need to care about that. However if you are using django in standard alone application, there is no trigger to run that function. So you have to call it manually. So let call close_old_connections in your code base.

Note: close_old_connections will keep old connections if they’re not expired yet. Your connections are still reused in case of high frequency query.


This way can also close the idle connections and make things good.

So before you need to make a query after a long time, running the below lines will work:

from django.db import close_old_connections

# To prevent the error if possible.
# Then the following sentence should be always ok.


If you need Django to auto-refresh database connection (for Django >= 4.1) you can enable persistent connections with health-checks

   'default': {
       'CONN_HEALTH_CHECKS': True,
       'CONN_MAX_AGE': 60,  # <= Mysql `interactive_timeout`/`wait_timeout`  

As result for each db request Django will ping database to check "if connection is alive" (DatabaseWrapper.is_usable) and restart connection if needed


Leave a comment