Ubuntu19.10でPython経由でmysqlに接続できなくてどちゃくそハマったので備忘録としてまとめます。
前提
今まで接続できていたPythonでのmysqlへの接続がエラーになりました。
エラーメッセージはだいぶ省略していますが、以下のように出ていました。
$ python manage.py showmigrations
ImportError: libmysqlclient.so.20: cannot open shared object file: No such file or directory
エラーになったときの環境
- Ubuntu 19.10
- mysql 5.7（接続しようとしているlocal環境のdockerのmysql）
- libmysqlclient21 8.0.17-0ubuntu2
- libmysqlclient-dev 8.0.17-0ubuntu2
- Python 3.7.3
- django 2.2.4
- mysqlclient 1.4.2.post1
エラー原因
ちょうど昨日Ubuntu19.04から19.10にアップデートしました。
原因を詳しく調べたわけではないですが、アップデートによりlibmysqlclientがmysql8に対応したことにより起きたエラーだと考えています。（あまり使ったことないので知らなかったのですが、mysql5.7 -> 8にアップデートしたらしい）
このあたりを見た感じはmysql8に対応したのは19.10のeoanからっぽいです。
https://www.ubuntuupdates.org/package_metas?q=libmysqlclient-dev
余談ですが、Ubuntu19.10より19.04の方がデザインが好きでした、狼かっこよかった。
対策（失敗）
エラーメッセージを見る限り、要はlibmysqlclient.so.20ファイルがないようです。
以下のようにlibmysqlclient.so.21はありました。
/usr/lib/x86_64-linux-gnu/libmysqlclient.so.21
なので、20 -> 21へのシンボリックリンクを作成すればいけるのではと思いました。
作成します。
$ sudo ln -s /usr/lib/x86_64-linux-gnu/libmysqlclient.so.21 /usr/lib/x86_64-linux-gnu/libmysqlclient.so.20
これで再度pythonコマンドを実行します、すると以下のエラーが...
ImportError: /usr/lib/x86_64-linux-gnu/libmysqlclient.so.20: version `libmysqlclient_20.0' not found
Pythonのほうでversionチェックを行ってるのですかね？おそらく。
シンボリックリンクを作成するのではダメだとわかりました。
削除しておきます。
sudo unlink /usr/lib/x86_64-linux-gnu/libmysqlclient.so.20
対策（成功）
libmysqlclient.so.20が動作することが必要なので、libmysqlclientとlibmysqlclient-devをダウングレードして再度インストールします。
aptでダウングレードしてインストールするのは初めてでした。
パッケージの情報は以下のようにして表示できます。
$ apt-cache showpkg libmysqlclient20 libmysqlclient-dev
そして以下のサイトからlibmysqlclient20_5.7.28とlibmysqlclient-dev_5.7.28のdebファイルをインストールします。
最初間違ってlibmysqlclient-dev_5.7.27-0ubuntu0.19.04.1_amd64.debをインストールしてしまってlibmysqlclient20とバージョン合わなくてうまくいかないということもありました。なので若干コマンドの順番前後してたりとかはあるかもしれません...
https://ubuntu.pkgs.org/19.04/mysql-5.7-amd64/libmysqlclient20_5.7.28-1ubuntu19.04_amd64.deb.html
https://ubuntu.pkgs.org/19.04/mysql-5.7-amd64/libmysqlclient-dev_5.7.28-1ubuntu19.04_amd64.deb.html
ダウンロードしたdebファイルをdpkgで入れます。
$ sudo dpkg -i libmysqlclient-dev_5.7.28-1ubuntu19.04_amd64.deb
$ sudo dpkg -i libmysqlclient20_5.7.28-1ubuntu19.04_amd64.deb
そしてupdateして、version指定してインストールします。
ちょっとこのあたり記憶が曖昧です、間違ってたらすみません...
$ sudo apt update
$ sudo apt install libmysqlclient-dev=5.7.28-1ubuntu19.04
$ sudo apt install libmysqlclient20_5.7.28-1ubuntu19.04
これで私の環境では以下のようになりました。
i libmysqlclient-dev 5.7.28-1ubuntu19.04 amd64 MySQL development headers
ii libmysqlclient20:amd64 5.7.28-1ubuntu19.04 amd64 MySQL shared client libraries
ii libmysqlclient21:amd64 8.0.17-0ubuntu2 amd64 MySQL database client library
Pythonを再度実行したらうまく接続できたようです！
しかしこのままではバージョンが低いものをインストールしているせいで、更新通知がくるのでバージョンを一旦固定にします。
$ sudo apt-mark hold libmysqlclient20
$ sudo apt-mark hold libmysqlclient-dev
これで通知は来なくなりました。解除するときはunholdを使うようです。
apt-mark unhold パッケージ名
所感
バージョン変えたことにより、接続できなかったり問題は発生したんですが調べてると結構色々勉強になりました。
途中やってて気づいたのですが、ローカル開発環境ですしmysqlのバージョンを8にしたりPythonの環境をdockerで作るなどしても良かったかもしれないなと思いました。
最近アウトプット的なことが全然できてないと思い、久しぶりに書いてみました。
今後ちょっとしたことでも書いていく癖をつけようと思います。