我之前也踩过Conda环境搭配Jupyter连接MySQL的坑，给你梳理几个大概率能解决问题的排查方向：

1. 先确认Jupyter和Conda环境的一致性 #

很多时候问题出在Jupyter没使用你安装了数据库包的Conda环境：

• 在Jupyter Notebook里运行这段代码，检查当前Python解释器路径：

  import sys
  print(sys.executable)
  

  输出的路径应该和你激活的Conda环境路径一致（比如~/miniconda3/envs/your_env/bin/python）。如果不一致，说明你用的是系统默认的Jupyter，需要先在激活的环境里安装Jupyter：

  conda activate your_env
  conda install jupyter # 或者 pip install jupyter
  

  之后再从这个环境启动Jupyter，就能调用到你装的数据库包了。

2. 检查数据库连接参数的正确性 #

不管用哪个库，连接参数出错是最常见的问题，给你几个常用库的正确示例：

mysql-connector-python #

import mysql.connector
try:
    cnx = mysql.connector.connect(
        user="你的MySQL用户名",
        password="你的密码",
        host="localhost", # 远程数据库填对应IP
        database="要连接的数据库名",
        port=3306 # 若修改过MySQL端口，要填对应值
    )
    print("连接成功！")
    cnx.close()
except mysql.connector.Error as err:
    print(f"错误信息: {err}")

pymysql + SQLAlchemy #

注意URL的格式必须正确，尤其是密码里有特殊字符时要转义：

from sqlalchemy import create_engine
from sqlalchemy.exc import SQLAlchemyError

try:
    # 格式：mysql+pymysql://用户名:密码@主机:端口/数据库名
    engine = create_engine("mysql+pymysql://root:your_password@localhost:3306/your_database")
    conn = engine.connect()
    print("连接成功！")
    conn.close()
except SQLAlchemyError as err:
    print(f"错误信息: {err}")

3. 处理MySQL权限和验证插件问题 #

• 权限问题：确认你的MySQL用户有从当前机器访问的权限。登录MySQL终端，执行：

  SELECT user, host FROM mysql.user;
  

  如果你的用户对应的host是localhost，那只能本地访问；如果是远程连接，需要创建或授权user@%（允许所有IP）或指定IP的用户：

  GRANT ALL PRIVILEGES ON your_database.* TO 'your_user'@'%' IDENTIFIED BY 'your_password';
  FLUSH PRIVILEGES;
  

• 验证插件问题：MySQL 8.0+默认用caching_sha2_password验证，pymysql可能不兼容。要么把用户的验证方式改成mysql_native_password：

  ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password';
  FLUSH PRIVILEGES;
  

  要么安装cryptography包来支持新验证方式：

  conda activate your_env
  conda install cryptography # 或 pip install cryptography
  

4. 排查网络和服务状态 #

• 确认MySQL服务正在运行：Windows可以在服务里查看，Linux执行systemctl status mysql。
• 本地防火墙是否放行3306端口，远程连接的话还要确认服务器防火墙和安全组开放了对应端口。
• 检查MySQL配置文件（比如my.cnf或my.ini）里的bind-address，如果是远程连接，不要设为127.0.0.1，改成0.0.0.0或允许的IP。

5. 尝试兼容的包版本 #

如果以上都没问题，可能是包版本和MySQL版本不兼容：

• 比如MySQL 8.0+搭配旧版pymysql会有问题，可以指定版本安装：

  pip install pymysql==1.0.2
  

• 或者用conda安装经过兼容测试的版本：

  conda install mysql-connector-python=8.0.30
  

最后提醒下：如果还是不行，一定要把具体的报错信息贴出来，比如是认证失败、连接超时还是找不到数据库，不同的错误对应不同的解决方向！

内容的提问来源于stack exchange，提问作者Alpha