Pythonの「ModuleNotFoundError: No module named 'MySQLdb'」エラーを解決する方法

MySQLは、Pythonから利用できる最も効率的なデータベースの一つです。Pythonモジュール「MySQLdb」を使えば、PythonとMySQLを簡単に接続できます。しかし、このモジュールがシステムにインストールされていない状態でインポートしようとすると、「No module named 'MySQLdb'」というエラーが発生します。

本記事では、「no module named mysqldb」エラーが発生する原因と、その具体的な解決策について詳しく解説します。

エラーが発生する原因

Pythonモジュールは、単一または複数のパッケージに依存して動作します。「MySQLdb」に関連するパッケージのいずれかがインストールされていない状態でモジュールをインポートしようとすると、「no module named mysqldb」というエラーが発生します。

実際にインポートを試みた際、以下のようにエラーが表示されます:

解決策:「MySQLdb」をインストールする

「MySQLdb」モジュールは、Python製パッケージマネージャーであるPIP経由で入手できます。まず、システムにPIPがインストールされていることを確認してください。以下の手順に沿って解決していきましょう。

ステップ1:PIPをインストールする

Linuxでは、使用しているディストリビューションに応じて、以下のいずれかのコマンドでPIPをインストールできます。

$ sudo apt install python3-pip           #Debian/Ubuntu系ディストリビューションの場合
$ sudo yum install python3-pip           #CentOS7/RHELの場合
$ sudo dnf install python3-pip           #Fedora/CentOS8の場合
$ sudo pacman -S python3-pip             #Arch系ディストリビューションの場合

なお、Python2環境にPIPをインストールする場合は、パッケージ名として「python-pip」を使用してください。

ステップ2:「mysqlclient」パッケージをインストールする

「MySQLdb」モジュールは2つのパッケージに関連しており、インポート前にそれぞれをインストールしておく必要があります。1つ目は「mysqlclient」で、PythonからMySQLへの接続を可能にする重要なパッケージです。

このパッケージが存在しないことが、モジュールをインポートできない主な原因となります。Linuxでは、以下のコマンドで「mysqlclient」をインストールできます。

$ pip3 install mysqlclient

「mysqlclient」のインストール中にエラーが発生する場合は、システムにPython開発用パッケージが不足している可能性があります。以下のコマンドで、必要な開発パッケージ一式を先にインストールしましょう。

$ sudo apt install python3-dev default-libmysqlclient-dev build-essential
$ sudo yum install python3-dev default-libmysqlclient-dev build-essential
$ sudo dnf install python3-dev default-libmysqlclient-dev build-essential

注意:「apt」「yum」「dnf」は、それぞれDebian/Ubuntu系、CentOS/RHEL系、Fedora系ディストリビューション向けのパッケージ管理コマンドです。

「mysqlclient」のインストール完了後、再度モジュールをインポートしてみてください。それでもエラーが解消しない場合は、次のステップに進みます。

ステップ3:「mysql-connector-python」をインストールする

このパッケージを利用すると、PythonからMySQLデータベースへ接続できるようになります。以下のPIPコマンドでインストールできます。

$ sudo pip3 install mysql-connector-python

Python2用のPIPを使用している場合は、「pip3」を「pip2」に置き換えて実行してください。

ステップ4:解決策を確認する

最後に、正式名称を指定してモジュールをインポートし、動作を確認します。

>>> import MySQLdb

エラーが表示されずにインポートが完了すれば、モジュールがPython環境に正しく組み込まれています。

まとめ

「no module named mysqldb」エラーは、必要なパッケージがインストールされていない状態でモジュールをインポートしようとした際に発生します。まずは「mysqlclient」パッケージをインストールすることで解決できるのが一般的です。それでも解決しない場合は、PIPを使って「mysql-connector-python」パッケージを追加でインストールしてみてください。本記事で紹介した手順を実践すれば、Linux環境での「MySQLdb」モジュールエラーを確実に解消できるでしょう。

著者について

Muhammad Zubyan(ムハンマド・ズビヤン)は、Google ITサポート認定プロフェッショナルであり、7年以上の豊富な経験を持つIT専門家です。1,500台以上のコンピューターを扱った経験をもとに、Windows関連の問題やエラーの複雑な根本原因を特定し、的確にトラブルシューティングする技術を培ってきました。現在はAppualsのシニアエディターとして執筆活動を行うほか、ゲーマーからカジュアルユーザーまで幅広く活用できるゲーム最適化ソフトウェアの開発にも取り組んでいます。