Python/Flask/MySQL应用启动报错：max_user_connections超限

问题背景 #

启动Flask应用时执行python -m flask run，未发起任何数据库请求即触发如下错误：

mysql.connector.errors.ProgrammingError: 1226 (42000): User [username] has exceeded the 'max_user_connections' resource (current value: 10)

已尝试添加try/except/finally块关闭连接、调大连接池pool_size、手动杀死MySQL进程、重启Heroku dynos等操作，问题仍未解决。

核心原因分析 #

当前代码在Flask应用初始化阶段就全局创建了MySQLConnectionPool实例，且设置pool_size=10。而MySQL用户的max_user_connections限制为10，这意味着应用启动时会一次性创建10个数据库连接，直接占满该用户的所有可用连接配额，导致后续操作（甚至未发起请求时）就触发连接数超限错误。

解决方案 #

1. 延迟连接池初始化，避免启动时占满连接 #

将连接池的创建逻辑改为懒加载，即第一次需要数据库连接时才初始化连接池，而非全局提前创建。修改代码如下：

# 全局仅声明变量，不初始化
cnxpool = None

def get_connection_pool():
    """懒加载创建MySQL连接池"""
    global cnxpool
    if not cnxpool:
        cnxpool = mysql.connector.pooling.MySQLConnectionPool(
            pool_name="name",                                      
            pool_size=5,  # 设置为小于10的数值，预留连接给其他工具使用
            autocommit=True,
            user=[user name],
            password=[password],
            host=[host],
            database=[database]
        )
    return cnxpool

# 在login路由中调用
@app.route("/login", methods=["GET", "POST"])
def login():
    # ... 其他代码
    try:
        # 通过懒加载函数获取连接池，再获取连接
        conn = get_connection_pool().get_connection()
        cur = conn.cursor(dictionary=True)
        # ... 执行查询逻辑
    # ... 其余异常处理和finally块

2. 合理设置连接池pool_size #

不要将pool_size设置为等于或超过max_user_connections的值。建议设为限制值的一半左右（比如5），预留部分连接给MySQL Workbench等管理工具使用，避免应用独占所有连接配额。

3. 优化连接资源的释放逻辑 #

确保游标和连接的初始化状态可控，避免因初始化异常导致资源未释放。调整try/finally块的变量初始化逻辑：

@app.route("/login", methods=["GET", "POST"])
def login():
    # ... 其他代码
    conn = None
    cur = None
    try:
        conn = get_connection_pool().get_connection()
        cur = conn.cursor(dictionary=True)
        cur.execute("SELECT * FROM businesses WHERE name = %s", (request.form.get("businessName"),))
        rows = cur.fetchall()
    except mysql.connector.Error as sqlerr:
        print(sqlerr)
    except Exception as err:
        print(err)
    else:
        # ... 登录验证逻辑
    finally:
        if cur:
            cur.close()
        if conn:
            conn.close()
    # ... 其余代码

4. 排查隐藏的连接占用情况 #

通过MySQL Workbench执行以下命令，确认连接占用来源：

• 查看当前用户的连接数限制：SHOW VARIABLES LIKE 'max_user_connections';
• 查看所有活跃连接：SHOW PROCESSLIST;

如果发现有来自旧dynos、其他应用实例的连接，可通过KILL [process_id];手动关闭，同时确保Heroku上没有残留的旧进程在占用连接。

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