Flask应用执行MySQL插入操作时报2003连接被主动拒绝错误的排查求助
Flask应用连接MySQL报2003错误的根因定位与修复方案
核心触发原因
- 配置参数的所属对象混淆是最高概率诱因
- 你代码中Flask服务自身的监听端口为8015,写在
app.run()方法的参数里 - 但MySQL连接配置中错误填写了端口8016,该端口上没有部署任何处于运行状态的监听服务,系统检测到没有进程接收对应端口的连接请求,就会直接返回10061连接主动拒绝的错误,和错误日志里的报错栈完全匹配
- 注意:MySQL连接配置块中的
host、port参数,指向的是MySQL数据库服务本身的网络地址,和Flask应用自身的运行端口没有任何关联,不能混用
- 你代码中Flask服务自身的监听端口为8015,写在
全链路排查步骤
- 确认MySQL服务的实际运行状态
- 打开Windows系统的服务管理器,检索名称包含MySQL的服务项,确认服务处于“正在运行”状态;如果服务未启动,手动启动后再测试连接,服务未运行时本地访问数据库也会触发同样的10061错误
- 打开MySQL的配置文件
my.ini,检索port配置项,确认MySQL实际监听的端口值,不要默认填熟知的3306,避免之前改过端口配置但没同步到代码里
- 排除本地网络解析干扰
- Windows环境下如果hosts文件配置异常,
localhost的解析可能出现偏差,测试时可以直接把连接参数里的host值换成127.0.0.1,绕开域名解析环节验证连通性 - 临时关闭Windows防火墙的入站规则拦截,测试是否是防火墙规则挡住了本地回环地址的数据库访问请求
- Windows环境下如果hosts文件配置异常,
修复参考代码
把错误的端口配置替换为MySQL实际监听的端口即可,比如使用MySQL默认3306端口的场景:
print("before connect") mydb = mysql.connector.connect( host="127.0.0.1", port=3306, # 替换为MySQL服务实际监听的端口,禁止填入Flask的运行端口8015/8016 user="root", password="MySQL实际配置的登录密码", database=dbname )
附带代码优化提示
- 现有代码没有增加数据库连接的异常捕获逻辑,一旦连接失败整个接口会直接抛出未处理的500错误,建议后续补充
try-except捕获数据库连接异常,返回友好的错误提示 - 当前的INSERT语句没有指定对应表的字段名称,依赖表结构的默认字段顺序做映射,一旦后续表结构调整字段顺序,会直接出现数据写入错位的问题,建议在SQL语句中明确声明插入的字段列表,和值一一对应
内容的提问来源于stack exchange,提问作者Niranjana Neeranj
相关产品推荐
相关产品推荐

