Fixing "ModuleNotFoundError: No module named 'mysql'" in Python


Python is a very dynamic and flexible language with a great ecosystem of modules and libraries. However, it can be very frustrating when you encounter module errors, like ModuleNotFoundError: No module named 'mysql'. At the very least, you should at least be able to easily install and use the packages, right?

Hopefully this Byte will help you understand and fix this error.

Understanding the 'No module named 'mysql'' Error

The ModuleNotFoundError: No module named 'mysql' error is encountered when you try to import the MySQL module in your Python script but the interpreter fails to locate it. This usually means that the MySQL module is not installed in your Python environment. Here is an example of how you might encounter this error:

import mysql.connector

If the MySQL module is not installed, running the above script will give you the following output:

ModuleNotFoundError: No module named 'mysql'

Checking if MySQL Package is Installed

Before we proceed to install the MySQL module, it's good practice to first check if it's already installed. You can do this by using the pip show command in your terminal:

$ pip show mysql-connector-python

If the MySQL module is installed, the above command will return information about the module. However, if it's not installed, the command will return nothing.

Note: Remember to use the correct pip command corresponding to your Python version - pip for Python 2, and pip3 for Python 3. After many years of using Python 3, this is still something I forget to do...

Verifying Python Version in Your IDE

Another common reason for the ModuleNotFoundError: No module named 'mysql' error is a mismatch between the Python version used in your IDE and the version in which the MySQL module is installed. You can check the Python version in your IDE by running the following command in your script:

import sys

The output will be something like this:

3.8.5 (default, Jan 27 2021, 15:41:15)
[GCC 9.3.0]

Ensure that the MySQL module is installed in the Python version that your IDE is using. If not, you may need to adjust your IDE settings or install the MySQL module in the correct Python version.

Using Virtual Environment for Package Installation

A virtual environment in Python is a space where you can install packages without affecting your global Python installation. It's a great way to isolate your project and its dependencies. If you're encountering the ModuleNotFoundError: No module named 'mysql' error, it could be that the MySQL package is not installed in your current virtual environment.

Here's how to create a new virtual environment and install the MySQL package within it.

Get free courses, guided projects, and more

No spam ever. Unsubscribe anytime. Read our Privacy Policy.

First, navigate to your project directory and create a new virtual environment using the venv module:

$ cd /path/to/your/project
$ python3 -m venv env

This will create a new folder named env in your project directory. To activate the virtual environment, run:

$ source env/bin/activate

Your command prompt should now start with (env), indicating that the virtual environment is active. Now, you can install the MySQL package:

(env) $ pip install mysql-connector-python

Now, you should be able to import the MySQL module in your Python scripts without encountering the ModuleNotFoundError.

Reinstallation of the MySQL Package

If you're not using a virtual environment, or if the error persists even after installing the MySQL package in your virtual environment, you might need to reinstall the MySQL package.

Uninstall the current MySQL package:

$ pip uninstall mysql-connector-python

Then, reinstall it:

$ pip install mysql-connector-python

Note: If you're using a virtual environment, make sure it's active when you run these commands!

Remember, Python is a great language, and much of its strength lies in its modules and libraries. But regardless, you'll still run into issues, like in any programming language. Understanding how to troubleshoot issues like this error will make you a more effective programmer.


In this Byte, we've covered two possible solutions to the ModuleNotFoundError: No module named 'mysql' error in Python. We've saw how to use a virtual environment to isolate your project and its dependencies, and how to reinstall the MySQL package.

Last Updated: August 14th, 2023
Was this helpful?

Building Your First Convolutional Neural Network With Keras

# python# artificial intelligence# machine learning# tensorflow

Most resources start with pristine datasets, start at importing and finish at validation. There's much more to know. Why was a class predicted? Where was...

David Landup
David Landup

Ā© 2013-2024 Stack Abuse. All rights reserved.