Mac环境下JDBC无法连接Docker中本地MySQL的问题求助

嘿，我仔细看了你的整个排查过程，确实是跨环境切换+MySQL/JDBC版本兼容性踩了一堆坑，能一步步摸清楚问题并解决已经很棒了！下面帮你梳理下问题脉络，再给点后续的实用建议👇

你正在开发一个依赖Docker容器中MySQL的Java应用，从Windows切换到Mac OS后，Java代码无法通过JDBC连接数据库，但MySQL Workbench和命令行能正常连接。使用Docker for Mac（无默认docker machine），启动容器的命令如下：

CONTAINER_NAME=hypo-mysql PORT="3306:3306" VOLUME_FROM="hypo-mysql-data" CONFIG_DIR="$(pwd)/conf.d" MYSQL_ROOT_PASSWORD="xxxxx" MYSQL_USER="hypo" MYSQL_PASSWORD="doktorBenArmsson" MYSQL_DATABASE="Hypo" docker run --name ${CONTAINER_NAME} \ 
-p ${PORT} \ 
--volumes-from ${VOLUME_FROM} \ 
-v ${CONFIG_DIR}:/etc/mysql/conf.d \ 
-e MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD} \ 
-e MYSQL_USER=${MYSQL_USER} \ 
-e MYSQL_PASSWORD=${MYSQL_PASSWORD} \ 
-e MYSQL_DATABASE=${MYSQL_DATABASE} \ 
-d --restart=always mysql \ 

1. 认证插件不兼容 #

最初启动Java应用时碰到的错误：

Caused by: java.sql.SQLException: Unable to load authentication plugin 'caching_sha2_password'.

这是因为MySQL 8.0+默认使用caching_sha2_password认证方式，而你用的旧版JDBC驱动（5.1.38）不支持这个插件。你通过修改用户认证方式解决了这个问题：

mysql> select user, host, plugin from user;
+------------------+-----------+-----------------------+
| user             | host      | plugin                |
+------------------+-----------+-----------------------+
| hypo             | %         | caching_sha2_password |
| root             | %         | caching_sha2_password |
| mysql.infoschema | localhost | mysql_native_password |
| mysql.session    | localhost | mysql_native_password |
| mysql.sys        | localhost | mysql_native_password |
| root             | localhost | caching_sha2_password |
+------------------+-----------+-----------------------+

ALTER USER 'hypo'@'%' IDENTIFIED WITH mysql_native_password BY 'xxxxxxx';

mysql> select user, host, plugin from user;
+------------------+-----------+-----------------------+
| user             | host      | plugin                |
+------------------+-----------+-----------------------+
| hypo             | %         | mysql_native_password |
| root             | %         | caching_sha2_password |
| mysql.infoschema | localhost | mysql_native_password |
| mysql.session    | localhost | mysql_native_password |
| mysql.sys        | localhost | mysql_native_password |
| root             | localhost | caching_sha2_password |
+------------------+-----------+-----------------------+

2. 系统变量不存在 #

解决认证问题后，又遇到新错误：

Caused by: java.sql.SQLException: Unknown system variable 'query_cache_size'

这是因为MySQL 8.0移除了查询缓存相关的系统变量，但旧版JDBC驱动还在尝试访问它。你尝试升级JDBC驱动到5.1.46：

//old driver: compile 'mysql:mysql-connector-java:5.1.38'
compile 'mysql:mysql-connector-java:5.1.46'

3. 密钥库验证失败 #

升级驱动后，出现了更棘手的密钥库错误：

Caused by: java.io.IOException: Keystore was tampered with, or password was incorrect
at sun.security.provider.JavaKeyStore.engineLoad(JavaKeyStore.java:780)
at sun.security.provider.JavaKeyStore$JKS.engineLoad(JavaKeyStore.java:56)
at sun.security.provider.KeyStoreDelegator.engineLoad(KeyStoreDelegator.java:224)
at sun.security.provider.JavaKeyStore$DualFormatJKS.engineLoad(JavaKeyStore.java:70)
at java.security.KeyStore.load(KeyStore.java:1445)
at com.mysql.jdbc.ExportControlled.getSSLSocketFactoryDefaultOrConfigured(ExportControlled.java:381)
... 27 more
Caused by: java.security.UnrecoverableKeyException: Password verification failed
at sun.security.provider.JavaKeyStore.engineLoad(JavaKeyStore.java:778)

你确认密码正确且重新生成密钥库后仍无效，最终通过切换到MySQL 5.x容器+恢复旧版JDBC驱动解决了问题：

docker ps -a
CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                    NAMES
8bf6b9ddd29f        mysql:5             "docker-entrypoint.s…"   15 seconds ago      Up 13 seconds       0.0.0.0:3306->3306/tcp   hypo-mysql
1a0add303fe0        mysql:5             "docker-entrypoint.s…"   4 minutes ago       Created                                 hypo-mysql-data

docker exec -it hypo-mysql bash
mysql --version
mysql Ver 14.14 Distrib 5.7.22, for Linux (x86_64) using EditLine wrapper

• 锁定MySQL容器版本：启动Docker容器时一定要指定具体的版本标签（比如mysql:5.7.22而不是mysql），否则Docker会默认拉取最新版，跨环境切换时很容易出现版本不一致的问题，这是你这次踩坑的根源之一。
• 版本匹配优先：MySQL 8+和JDBC驱动的兼容性问题非常多（认证方式、系统变量、SSL连接逻辑都有变化），如果你的项目没有必须使用MySQL 8+的需求，保持MySQL 5.x和对应旧版JDBC驱动的组合是最省心的，能避免大量兼容性调试工作。
• 密钥库错误的补充方案：如果之后需要升级到MySQL 8+，遇到密钥库错误时可以试试这两个办法：
  • 检查JDBC URL是否开启了SSL连接，如果不需要SSL，添加useSSL=false参数关闭，避免触发密钥库验证流程；
  • 如果必须使用SSL，确保本地Java默认密钥库（路径是$JAVA_HOME/jre/lib/security/cacerts）的密码正确（默认密码是changeit），或者在JDBC URL中指定自定义密钥库的路径和密码。
• 跨环境一致性：Windows和Mac的Docker网络模型虽然有细微差异，但你这次的问题核心还是版本不兼容。后续切换开发环境时，尽量保持容器镜像版本、依赖库版本的完全一致，能减少很多不必要的麻烦。

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