UbuntuでPyQt5を実行する

UbuntuでPyQt5アプリケーションを実行したとき、次のQtプラットフォームプラグインのエラーに遭遇しました。

qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.
This application failed to start because no Qt platform plugin could be initialized.

私の場合、アプリケーションはxcb Qtプラットフォームプラグイン自体は見つけられていましたが、そのプラグインが必要とするライブラリの1つが不足していました。不足しているxcb依存関係をインストールすると問題は解決しました。

最初の有用な確認方法は、Qtプラグインのデバッグを有効にしてアプリケーションを実行することです。

QT_DEBUG_PLUGINS=1 python3 your_app.py

通常、この出力には、どの共有ライブラリの読み込みに失敗したかが表示されます。多くのUbuntu環境では、不足しているパッケージはlibxcbランタイムライブラリのいずれかです。よくある修正方法は次のとおりです。

sudo apt update
sudo apt install libxcb-xinerama0

それでもエラーが残る場合は、QT_DEBUG_PLUGINS=1で報告された具体的な不足ライブラリを提供するパッケージをインストールしてください。次のコマンドで検索できます。

apt-file search name-of-missing-library.so

apt-fileがまだインストールされていない場合は、次のようにします。

sudo apt install apt-file
sudo apt-file update

不足しているライブラリをインストールしたら、PyQt5アプリケーションをもう一度実行します。xcbプラグインがすべての依存関係を読み込めるようになっていれば、アプリケーションは正常に起動するはずです。