PythonでMySQLに接続時に強制終了する原因と解決方法

PythonでMySQLに接続する際、import文の位置によってコードの挙動が変わることがあります。本記事では、PySide6を用いたGUIアプリケーションでMySQL接続時に発生する強制終了の原因と、その解決方法について解説します。

なぜプログラムが強制終了するのか？
Pythonのimportの仕組みと影響
解決策：importを最上部に移動
その他の注意点
まとめ

なぜプログラムが強制終了するのか？

今回のコードでは、次のような挙動が発生しています。

import mysql.connector を クラスの中で インポート → プログラムが強制終了
import mysql.connector を 最上部に移動 → 正常に動作

この問題の主な原因は、MySQL ConnectorのインポートとPySide6のイベントループの相互作用にあります。

Pythonのimportの仕組みと影響

Pythonでは、モジュールは最初にインポートされたときにロードされ、グローバルスコープに登録されるという仕様があります。

例えば、次のようにクラスの中で import mysql.connector を実行すると、クラスのインスタンス化時にのみロードされるため、予期しない動作が発生する可能性があります。

class RegisterWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        import mysql.connector  # ← ここでインポートすると問題が起こる可能性あり
        mydb = mysql.connector.connect(
            host="127.0.0.1",
            user="root",
            password="your_password"
        )

このコードでは、PySide6のイベントループの準備が整う前に、MySQL接続処理が開始されるため、意図しないエラーが発生する可能性があります。

解決策：importを最上部に移動

この問題を防ぐために、import mysql.connector をスクリプトの最上部に記述しましょう。

import mysql.connector  # 最上部でインポート
from PySide6.QtWidgets import *
from PySide6.QtCore import *
from PySide6.QtGui import *
from login import Ui_MainWindow
import sys

class RegisterWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.ui = Ui_MainWindow()
        self.ui.setupUi(self)
        print("1")
        mydb = mysql.connector.connect(
            host="127.0.0.1",
            user="root",
            password="your_password"
        )
        print(mydb)
        print("2")

この修正により、Pythonのインポート処理がプログラムの起動時に一度だけ実行されるため、MySQL接続時の不具合を防ぐことができます。

その他の注意点

MySQL Connectorがインストールされているか確認：pip install mysql-connector-python でインストールされていることを確認
MySQLサーバーが起動しているか確認：MySQLが正しく起動しているか、接続情報が正しいか確認
エラーメッセージの確認：try-except を使用して、エラーをキャッチし、詳細な情報を出力する