讲师中心 微信公众号
AI工具推荐 视频效率加速

mysql环境搭建后连接客户端工具配置指南

胖墨姑娘_8488

胖墨姑娘_8488

发布时间:2026-02-19 11:09:11

|

742人浏览过

|

来源于php中文网

原创

MySQL本地连接失败主因是服务未监听TCP端口或IPv4/IPv6解析冲突;认证失败因8.0+默认caching_sha2_password协议不兼容旧客户端;字符集乱码源于latin1默认配置未改utf8mb4。

mysql环境搭建后连接客户端工具配置指南

MySQL 服务启动后连不上 localhost 是什么情况

多数人装完 MySQL,mysql -u root -p 命令能进,但用 Navicat、DBeaver 或 MySQL Workbench 连 localhost 就报错 —— 典型是服务没监听 TCP 端口,或绑定了 127.0.0.1 却被客户端解析成 IPv6 的 ::1。

检查方法:

netstat -tuln | grep :3306
如果只看到 127.0.0.1:3306,说明只接受 IPv4 回环;如果没输出,说明 skip-networking 开着或 bind-address 被设成了 127.0.0.1 以外的值(比如 0.0.0.0 但防火墙拦了)。

  • 确认 my.cnf(Linux)或 my.ini(Windows)里没有 skip-networking = 1
  • bind-address 推荐设为 127.0.0.1(仅本地)或 0.0.0.0(全网卡,注意防火墙)
  • 改完重启服务:sudo systemctl restart mysql(Linux)或服务管理器重启 MySQL 服务

Navicat 连接时提示 “Client does not support authentication protocol”

这是 MySQL 8.0+ 默认用 caching_sha2_password 插件,而老版本 Navicat(v12 以前)、某些 Python 驱动(如 PyMySQL 0.9 以下)不支持。不是密码错了,是认证协议不兼容。

临时解决(开发环境可用):

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';
然后 FLUSH PRIVILEGES;。

  • 生产环境不建议降级认证方式,应升级客户端工具或驱动
  • 若用 Docker 启 MySQL 8,加启动参数:--default-authentication-plugin=mysql_native_password
  • 连接字符串里显式指定 auth plugin(如 JDBC:<code>?serverTimezone=UTC&allowPublicKeyRetrieval=true&useSSL=false</code>)

DBeaver 连接 MySQL 8 报错 “Public Key Retrieval is not allowed”

本质是 MySQL 8 的安全策略变更:当服务端要求公钥交换(比如用 caching_sha2_password),客户端默认禁止自动获取公钥,防止中间人攻击。DBeaver 默认关掉了这个开关。

MySQL
MySQL

编写正确的MySQL查询,避免字符集、索引和锁方面的常见陷阱。

下载

解决方法是在连接配置的 Driver Properties 里手动加两个参数:

  • allowPublicKeyRetrieval → 设为 true
  • useSSL → 设为 false(本地开发可关;生产必须开 SSL 或配证书)

注意:不能只改 URL,DBeaver 的 MySQL 驱动(MySQL Connector/J)必须 ≥ 8.0.15 才完整支持 caching_sha2_password;低于此版本即使加参数也无效。

客户端连上但查不到数据库或表名乱码

常见于 Windows 安装包默认字符集是 latin1,而建库时没指定 CHARACTER SET utf8mb4,导致客户端发 UTF-8 请求,服务端按 latin1 解,结果表名显示成问号或乱码符号。

验证当前连接字符集:

SHOW VARIABLES LIKE 'character_set%';<br>SHOW VARIABLES LIKE 'collation%';
关键看 character_set_client、character_set_connection、character_set_database 是否都是 utf8mb4。

  • 永久修复:在 my.cnf 的 [mysqld] 段加:
    character-set-server = utf8mb4
    collation-server = utf8mb4_unicode_ci
  • 客户端工具(如 Navicat)连接时,在高级设置里勾选「使用 MySQL 字符集」或手动填 utf8mb4
  • 已有库表乱码?ALTER DATABASE db_name CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;,再逐表 ALTER TABLE,但数据已损毁的需从备份恢复

字符集这事一旦漏掉初始化配置,后面补救成本远高于起步时多敲两行配置。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

2113

2023.06.20

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

1299

2023.06.21

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

755

2023.07.18

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2832

2023.07.19

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

4728

2023.07.25

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

1079

2023.08.08

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

4991

2023.08.11

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

4442

2023.08.14

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

100

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 181人学习

使用phpenv集成环境安装极致CMS
使用phpenv集成环境安装极致CMS

共2课时 | 287人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn