Flask应用连接本地MySQL触发OperationalError(2059, <NULL>)求助

这个错误在Flask对接MySQL的场景里挺常见的，本质是客户端与服务器的认证协议不兼容，除了你可能已经排查的方向，还有这些容易忽略的诱因：

• MySQL 8.0+的默认认证插件变更：MySQL 8.0及以上版本默认启用caching_sha2_password认证插件，但旧版flask-mysqldb依赖的mysqlclient（或MySQL-python）库可能不支持这个新插件。你可以先查下root@localhost用户的认证插件类型：

  SELECT user, host, plugin FROM mysql.user WHERE user = 'root';
  

  如果结果是caching_sha2_password，可以改成兼容的mysql_native_password：

  ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '<你的密码>';
  FLUSH PRIVILEGES;
  

• 密码的特殊字符转义问题：如果你的数据库密码包含@、#、$这类特殊字符，直接写在app.config里可能会被解析错误，导致认证失败。试试用Python原始字符串来定义密码（比如r"<password_ph>"），或者仔细检查密码是否拼写正确。

• MySQL服务的端口/运行状态异常：虽然配置的是localhost，但如果MySQL服务没启动，或者监听的不是默认3306端口（你改了端口但配置里没指定），也会触发这个连接错误。可以先确认MySQL服务是否正常运行，或者在配置里明确指定端口：

  app.config["MYSQL_DATABASE_PORT"] = 3306
  

• 本地Socket文件权限问题：MySQL通过本地Socket连接时，如果运行Flask的用户没有访问Socket文件的权限（比如Socket路径是/var/run/mysqld/mysqld.sock），也会导致连接失败。可以在配置里指定Socket路径，同时确保用户有读写权限：

  app.config["MYSQL_DATABASE_UNIX_SOCKET"] = "/var/run/mysqld/mysqld.sock"
  

• 依赖版本兼容性问题：旧版本的flask-mysqldb可能和新版MySQL不兼容，试试升级到最新版本：

  pip install --upgrade flask-mysqldb
  

• 数据库权限配置异常：虽然用的是root用户，但如果root@localhost没有被授予访问myfirstdb的权限，偶尔也会以连接错误的形式表现出来。可以重新授权试试：

  GRANT ALL PRIVILEGES ON myfirstdb.* TO 'root'@'localhost';
  FLUSH PRIVILEGES;
  

另外提个小建议：你代码里的INSERT语句可以简化，因为已经通过配置指定了数据库，直接写表名就行：

cur.execute("INSERT INTO firstflaskapp(name, email, username, password) VALUES(%s, %s, %s, %s)", (name, email, username, password))

内容的提问来源于stack exchange，提问作者Dominik Remetei