Flask-MySQL忽略host参数连接MySQL报错该如何排查解决

1. Host配置未生效的核心原因 #

该问题是导致Docker环境报2003错误的根因，常见触发场景如下：

• 初始化顺序错误：通过app.config配置的场景下，必须先完成所有MYSQL_*参数的配置，再执行MySQL(app)初始化操作，如果顺序反转，配置不会被组件读取，会默认回退到localhost作为数据库地址。
• prefix参数配置错误：直接传参初始化的场景下，如果传入了自定义prefix参数，要确保prefix取值和参数名匹配，拼写错误会导致所有自定义参数不生效，直接加载默认值。
• 多环境配置覆盖：如果项目存在分环境的配置文件，要确认Docker运行时加载的配置没有把MYSQL_HOST覆盖为localhost。
• 应用工厂模式适配错误：如果使用Flask应用工厂模式，不能直接在全局实例化MySQL时传app，要在工厂函数内部调用mysql.init_app(app)完成初始化，否则配置不会被加载。

2. 本地运行1044权限报错解决 #

该报错说明配置已经生效，是MySQL侧权限配置问题导致：

• 执行SQL语句给用户分配对应数据库的权限：

GRANT ALL PRIVILEGES ON testDB.* TO 'testusr'@'%' IDENTIFIED BY '你的testusr账户密码';
FLUSH PRIVILEGES;

• 注意Linux环境下MySQL库名大小写敏感，要确认实际库名和配置里的testDB拼写完全一致。

3. Docker环境连接补充配置 #

解决Host配置生效问题后，还需要完成以下配置才能正常连接宿主机数据库：

• 修改MySQL配置文件my.cnf，将bind-address参数调整为0.0.0.0或者Docker网桥网段172.17.0.0/16，避免MySQL只接收本地请求。
• 放开宿主机防火墙3306端口对Docker网段的访问限制。

正确配置示例 #

方式1：直接传参初始化

from flask import Flask
from flask_mysql import MySQL

app = Flask(__name__)
mysql = MySQL(
    app,
    host='172.17.0.2',
    user='testusr',
    password='你的数据库密码',
    db='testDB'
)

方式2：通过app.config配置

from flask import Flask
from flask_mysql import MySQL

app = Flask(__name__)
# 先配置参数，再初始化组件
app.config['MYSQL_HOST'] = '172.17.0.2'
app.config['MYSQL_USER'] = 'testusr'
app.config['MYSQL_PASSWORD'] = '你的数据库密码'
app.config['MYSQL_DB'] = 'testDB'
mysql = MySQL(app)

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