You need to enable JavaScript to run this app. Flask应用执行MySQL插入操作时报2003连接被主动拒绝错误的排查求助
优惠活动
大模型
产品
解决方案
定价
更多

Flask应用执行MySQL插入操作时报2003连接被主动拒绝错误的排查求助

Flask应用连接MySQL报2003错误的根因定位与修复方案

核心触发原因

  • 配置参数的所属对象混淆是最高概率诱因
    • 你代码中Flask服务自身的监听端口为8015,写在app.run()方法的参数里
    • 但MySQL连接配置中错误填写了端口8016,该端口上没有部署任何处于运行状态的监听服务,系统检测到没有进程接收对应端口的连接请求,就会直接返回10061连接主动拒绝的错误,和错误日志里的报错栈完全匹配
    • 注意:MySQL连接配置块中的host、port参数,指向的是MySQL数据库服务本身的网络地址,和Flask应用自身的运行端口没有任何关联,不能混用

全链路排查步骤

  1. 确认MySQL服务的实际运行状态
    • 打开Windows系统的服务管理器,检索名称包含MySQL的服务项,确认服务处于“正在运行”状态;如果服务未启动,手动启动后再测试连接,服务未运行时本地访问数据库也会触发同样的10061错误
    • 打开MySQL的配置文件my.ini,检索port配置项,确认MySQL实际监听的端口值,不要默认填熟知的3306,避免之前改过端口配置但没同步到代码里
  2. 排除本地网络解析干扰
    • Windows环境下如果hosts文件配置异常,localhost的解析可能出现偏差,测试时可以直接把连接参数里的host值换成127.0.0.1,绕开域名解析环节验证连通性
    • 临时关闭Windows防火墙的入站规则拦截,测试是否是防火墙规则挡住了本地回环地址的数据库访问请求

修复参考代码

把错误的端口配置替换为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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.04 05:24:03