在 Docker 容器内安装 MySQL 时出现 authentication plugin 'caching_sha2_password' cannot be loaded 错误解决方案

背景

在进行前端开发时，我们通常需要使用 MySQL 数据库来存储数据。而在开发过程中，我们可能会使用 Docker 来搭建开发环境，以便于团队协作和开发效率提升。但是，在 Docker 容器内安装 MySQL 时，有时会遇到 authentication plugin 'caching_sha2_password' cannot be loaded 错误，导致 MySQL 无法正常启动。本文将介绍这一错误的原因和解决方案。

错误原因

在 MySQL 8.0 版本中，引入了 caching_sha2_password 认证插件，用于提高密码安全性。然而，该插件在某些情况下可能会导致无法加载，从而导致 MySQL 无法启动。这通常是因为 MySQL 客户端版本与 MySQL 服务器版本不兼容所致。

解决方案

方案一：升级 MySQL 客户端版本

如果您的 MySQL 客户端版本较低，可能会出现 authentication plugin 'caching_sha2_password' cannot be loaded 错误。您可以尝试升级 MySQL 客户端版本，以解决该问题。

方案二：修改 MySQL 配置文件

如果您无法升级 MySQL 客户端版本，可以尝试修改 MySQL 配置文件，禁用 caching_sha2_password 认证插件。具体操作如下：

1. 进入 MySQL 容器

docker exec -it mysql-container bash

1. 进入 MySQL 配置文件目录

cd /etc/mysql/conf.d/

1. 创建新的配置文件

touch disable_caching_sha2_password.cnf

1. 编辑配置文件，添加以下内容

[mysqld]
default-authentication-plugin=mysql_native_password

1. 重启 MySQL 服务

service mysql restart

方案三：使用 MySQL 5.7 版本

如果您无法解决 authentication plugin 'caching_sha2_password' cannot be loaded 错误，可以尝试使用 MySQL 5.7 版本，该版本不会出现该错误。

总结

在 Docker 容器内安装 MySQL 时，可能会遇到 authentication plugin 'caching_sha2_password' cannot be loaded 错误。本文介绍了该错误的原因和解决方案，包括升级 MySQL 客户端版本、修改 MySQL 配置文件和使用 MySQL 5.7 版本。希望本文能够帮助您解决相关问题，提高开发效率。

来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/65cc734dadd4f0e0ff5d9b3f