连接Docker部署的MySQL容器报Unknown MySQL server host错误如何解决

问题原因解析 #

你遇到的报错本质是MySQL客户端参数规则和环境变量作用范围的问题，核心原因有3个：

• MYSQL_HOST是MySQL客户端工具的专属环境变量，和MySQL服务端运行配置无关。MySQL官方镜像的服务端默认就会监听容器内0.0.0.0的3306端口，不需要通过这个变量配置，你在compose.env里配置这个变量，只会影响容器内执行mysql、mysqldump等客户端命令时的默认连接参数，不会修改服务端的监听逻辑。
• MySQL客户端的host参数仅支持填写纯IP/域名，不能携带端口号。你最开始的报错提示Unknown MySQL server host '127.0.0.1:3306'，说明你之前的MYSQL_HOST赋值里包含了:3306端口后缀，客户端会把整个127.0.0.1:3306字符串当做主机名去解析，自然会识别失败。哪怕你后续改成纯IP，也是多余的配置，还可能触发额外的鉴权规则。
• 容器内本地连接MySQL默认走Unix套接字链路，不需要指定HOST。删除MYSQL_HOST变量后，mysql命令会自动走默认的Unix套接字路径/var/run/mysqld/mysqld.sock连接本地服务，不需要走TCP链路、不需要解析IP，只要MySQL服务正常运行就能直接连上，因此功能恢复正常。

补充说明 #

如果后续需要从容器外部（比如本地终端、本地数据库GUI工具）连接容器内的MySQL，直接用本地127.0.0.1:3306即可，和容器内的MYSQL_HOST变量没有任何关联。

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