使用Flask-MySQLdb开发REST API时POST请求报KeyError: 'MYSQL_HOST'错误

错误核心含义 #

报错最终抛出的KeyError: 'MYSQL_HOST'属于Flask-MySQLdb扩展的配置读取类错误，并非业务入参逻辑类错误。
错误触发逻辑：代码执行mysql.connection.cursor()尝试建立数据库连接、获取操作游标时，Flask-MySQLdb会优先从当前Flask应用的配置字典current_app.config中读取MYSQL_HOST配置项，但当前应用的配置集合中不存在这个键，直接触发Python字典取值越界异常，最终返回HTTP 500内部服务器错误。

错误执行链路还原 #

从堆栈跟踪可定位完整触发流程：

• 服务接收到/api/auth/login路由的POST请求，解析到入参{'username': 'ah', 'password': 'oh'}
• 路由处理逻辑进入resources.py的post方法，调用User.fetch_userid_from_db(post_data['username'])
• 进入models.py的用户查询方法，执行cur = mysql.connection.cursor()尝试获取数据库操作游标
• Flask-MySQLdb内部尝试读取current_app.config['MYSQL_HOST']时发现配置缺失，抛出异常

常见修复方案 #

按出现概率从高到低排序：

1. 未在Flask应用初始化阶段配置MySQL连接参数
   Flask-MySQLdb要求必须在初始化MySQL扩展前，在应用配置中写入固定键名的连接参数，标准初始化代码如下：

   from flask import Flask
   from flask_mysqldb import MySQL
   
   app = Flask(__name__)
   # 必须使用官方规定的固定配置键名，不可自定义命名
   app.config['MYSQL_HOST'] = '127.0.0.1'
   app.config['MYSQL_USER'] = '数据库连接账号'
   app.config['MYSQL_PASSWORD'] = '数据库连接密码'
   app.config['MYSQL_DB'] = '关联的业务数据库名'
   app.config['MYSQL_PORT'] = 3306
   
   # 完成扩展与Flask应用实例的绑定
   mysql = MySQL(app)
   

2. 模块导入时序错误
   如果将mysql扩展实例的导入、绑定操作拆分到不同文件，需要确保MySQL(app)的绑定操作，早于models.py模块中对mysql.connection的调用。若models模块被提前导入，此时扩展还未绑定到Flask应用实例，就会出现配置读取失败的问题。
3. 配置键名书写错误
   常见键名书写错误包括将MYSQL_HOST写成MYSQL_HOSTNAME、MYSQL_SERVER、MYSQL_IP这类自定义名称，和Flask-MySQLdb的固定配置规范不匹配，也会直接触发该KeyError。

内容的提问来源于Stack Exchange，提问作者Blooky