Jupyter Notebook连接MySQL时内核崩溃重启问题求助

排查方向与解决方案 #

1. 修复mysql-connector-python版本兼容性问题 #

内核崩溃常和依赖版本不兼容相关，可尝试安装兼容性较好的指定版本：

pip uninstall mysql-connector-python -y
pip install mysql-connector-python==8.0.30

2. 替换为pymysql连接MySQL #

mysql.connector偶尔会和Jupyter内核环境产生冲突，换用pymysql测试：
先安装依赖：

pip install pymysql

再修改连接代码：

import pymysql

cnx = pymysql.connect(
    host="127.0.0.1",
    port=3306,
    user="root",
    password="root"
)

3. 对齐Jupyter内核与依赖安装环境 #

确保Jupyter使用的Python环境和安装MySQL依赖的环境一致：

• 在Jupyter中执行以下代码查看当前环境路径：

import sys
print(sys.executable)

• 用该路径执行依赖安装，示例：

# 替换为上述输出的实际路径
/path/to/your/python -m pip install mysql-connector-python

4. 验证MySQL服务与账号权限 #

• 确认本地MySQL服务处于运行状态：
  • Windows：打开服务管理器，找到MySQL服务并启动
  • Linux/macOS：执行sudo systemctl start mysql（对应系统的启动命令）
• 验证root账号可正常登录：在终端执行mysql -u root -p，输入密码后能进入命令行则账号密码与服务无问题

5. 查看内核崩溃的详细报错信息 #

修改Jupyter配置以显示完整错误堆栈：

• 生成配置文件（未生成过则执行）：

jupyter notebook --generate-config

• 打开配置文件，找到c.NotebookApp.kernel_manager_class，修改为：

c.NotebookApp.kernel_manager_class = 'jupyter_client.manager.KernelManager'

• 重启Jupyter后再次执行代码，根据详细报错定位具体问题

内容的提问来源于stack exchange，提问作者Dhanush G. R.