Flask-Migrate连接Docker MySQL时出现1045权限拒绝错误

1. 核对Flask-Migrate的数据库配置 #

• 确认Flask应用加载的配置文件和原生SQLAlchemy、命令行使用的完全一致。有时Flask-Migrate会读取不同的环境变量或配置文件，导致连接串的用户名、密码、主机地址出错。
• 直接打印当前应用的数据库URI验证：

  from your_app import app
  print(app.config['SQLALCHEMY_DATABASE_URI'])
  

  对比该URI与你命令行/原生SQLAlchemy的连接串，重点检查主机IP、密码、用户名是否完全匹配。

2. 验证MySQL用户的IP访问权限 #

• 命令行连接可能是从localhost或127.0.0.1发起的，但Flask-Migrate运行环境的IP是10.x.x.x，需确认root用户允许从该IP访问。
• 登录MySQL命令行，执行以下命令查看用户权限：

  SELECT user, host FROM mysql.user WHERE user = 'root';
  

  若没有root@10.x.x.x或root@%（允许所有IP）的记录，执行授权：

  GRANT ALL PRIVILEGES ON your_database.* TO 'root'@'10.x.x.x' IDENTIFIED BY 'your_password';
  FLUSH PRIVILEGES;
  

3. 检查Docker网络配置 #

• 确认Flask容器和MySQL容器处于同一Docker网络，否则跨网络可能出现访问限制或IP解析错误。
• 查看容器所属网络：

  docker network ls
  docker inspect <flask-container-name> | grep Networks
  docker inspect <mysql-container-name> | grep Networks
  

  若不在同一网络，将Flask容器连接到MySQL所在网络：

  docker network connect <mysql-network-name> <flask-container-name>
  

4. 确认flask db命令的执行环境 #

• 若在宿主机执行flask db命令，需确保宿主机能访问MySQL容器的端口，且连接串主机地址是宿主机IP或Docker网关IP，而非容器内部IP。
• 优先尝试进入Flask容器内部执行flask db init/migrate，规避宿主机与容器间的网络差异问题。

5. 对比SQLAlchemy连接参数 #

• 原生SQLAlchemy代码可能使用了额外连接参数（如charset=utf8mb4、ssl_mode），而Flask-Migrate配置未包含，导致连接失败。对比两者的连接配置，确保参数完全一致。

内容的提问来源于stack exchange，提问作者J.K Jeon