在Flask应用开发中，调用数据库查询接口时返回空结果，但手动在MySQL客户端执行相同SQL却能拿到数据，这类问题往往和MySQL版本兼容性直接相关。不同版本的MySQL在认证协议、字符集默认配置、驱动适配规则上存在差异，很容易和Flask使用的数据库扩展产生冲突，最终导致查询无结果。
常见的版本兼容问题场景
1 MySQL驱动版本不匹配
Flask常用的MySQL驱动有mysqlclient、pymysql、mysql-connector-python，不同驱动对MySQL版本的适配范围不同。比如mysqlclient1.4.x版本不支持MySQL 8.0以上的默认认证方式，连接时虽然不报错，但执行查询时会返回空结果。
2 认证协议差异
MySQL 8.0及以上版本默认使用caching_sha2_password认证插件，而部分旧版本的数据库驱动仅支持mysql_native_password插件，认证过程中的兼容问题会导致查询请求无法正常被处理，最终返回空结果。
3 字符集配置冲突
高版本MySQL默认字符集为utf8mb4，如果Flask应用的数据库连接配置中字符集设置为utf8，且驱动版本不支持字符集自动适配，会导致查询条件编码错误，无法匹配到数据库中的实际数据。
问题排查步骤
- 首先确认Flask使用的数据库驱动版本，以及当前MySQL的服务版本，核对驱动的官方适配说明，确认是否存在版本不兼容情况。
- 检查数据库连接的配置参数，重点查看认证插件、字符集、端口等配置是否和MySQL服务端的配置一致。
- 开启Flask应用的SQL执行日志，查看实际发送到MySQL的SQL语句是否和预期一致，同时查看MySQL服务端的慢查询日志和错误日志，定位请求处理过程中的异常。
对应的解决方法
调整驱动版本
如果是驱动版本过低不支持高版本MySQL，可以升级驱动到适配版本。比如使用pymysql连接MySQL 8.0以上版本，可以将pymysql升级到1.0.2及以上版本，适配新的认证协议。
以下是Flask中配置pymysql连接MySQL的示例代码：
from flask import Flask
from flask_sqlalchemy import SQLAlchemy
app = Flask(__name__)
# 配置数据库连接，指定使用pymysql驱动，字符集为utf8mb4
app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql+pymysql://username:password@127.0.0.1:3306/test_db?charset=utf8mb4'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
db = SQLAlchemy(app)
# 定义数据模型
class User(db.Model):
id = db.Column(db.Integer, primary_key=True)
name = db.Column(db.String(50))
# 查询示例
with app.app_context():
# 执行查询，查看是否返回结果
user_list = User.query.filter_by(name='test').all()
print(user_list)
修改MySQL认证插件
如果不想升级驱动，可以修改MySQL用户的认证插件为mysql_native_password，执行以下SQL语句即可：
-- 修改指定用户的认证插件 ALTER USER 'username'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY 'password'; -- 刷新权限 FLUSH PRIVILEGES;
统一字符集配置
在Flask的数据库连接URI中显式指定字符集为utf8mb4，同时确认MySQL服务端的默认字符集也配置为utf8mb4，避免编码不一致导致的查询匹配失败。
注意事项
修改MySQL配置或者驱动版本后，需要重启Flask应用和MySQL服务让配置生效。如果排查后仍然没有结果，可以检查SQL语句中是否存在表名、字段名大小写的问题，部分系统下MySQL表名大小写敏感配置也会导致查询无结果。