Spring Boot项目无法连接Docker部署的MySQL8 报root用户172.21.0.1访问被拒错误
问题根因定位
- 授权IP匹配完全失效:异常日志明确标注访问来源IP为
172.21.0.1,但此前执行的授权命令中填写的主机地址是127.21.0.1,IP字段存在拼写偏差,授权规则完全没有覆盖实际的访问来源 - docker-compose配置不符合MySQL官方镜像逻辑:
MYSQL_USER参数的设计用途是创建独立的非root业务账号,将其设置为root会和镜像内置的root用户初始化逻辑冲突,容易导致权限校验规则混乱 - 端口映射的源IP映射认知偏差:虽然Spring Boot配置的数据库地址是
localhost:3306,但经过Docker端口映射的NAT转发规则时,部分JDBC连接进入容器网络的源IP会被替换为Docker网桥的网关地址(也就是日志中的172.21.0.1),无法匹配你之前配置的root@localhost、root@127.x.x.x这类本地回环授权规则,这也是为什么MySQL Workbench、本地终端能正常连接,但Spring Boot应用被拒的核心原因。
分步解决操作
- 修正docker-compose.yml的错误配置
删除和root初始化逻辑冲突的冗余配置,调整后的配置如下:version: '3.1' services: mysql: image: mysql restart: always environment: MYSQL_ROOT_PASSWORD: 020688 MYSQL_DATABASE: ticketdb # 移除原有 MYSQL_USER: root 配置,避免破坏内置root初始化流程 ports: - '3306:3306' - 清理旧实例数据,重建MySQL服务
旧容器在初始化阶段已经被错误的环境变量写入了混乱的用户权限规则,单纯重启容器无法修正,需要先停止删除旧容器、清除对应的数据卷(如果之前配置了持久化目录),再执行docker-compose up -d重新拉起MySQL实例。 - 执行正确的权限授权
本地开发场景不需要严格限制访问来源IP,直接开放root从任意主机的访问权限即可,避免后续Docker网段变动再次出现IP匹配失败的问题,执行命令如下:
如果坚持限制IP范围,就将授权规则中的主机地址替换为日志里实际出现的-- 覆盖所有可能的来源IP,避免后续反复调整授权规则 CREATE USER IF NOT EXISTS 'root'@'%' IDENTIFIED BY '020688'; GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' WITH GRANT OPTION; FLUSH PRIVILEGES;172.21.0.1,不要继续使用拼写错误的127.21.0.1。
可选优化项
- 当前配置的JPA方言
org.hibernate.dialect.MySQL5InnoDBDialect适配MySQL5.x版本,连接MySQL8时建议替换为org.hibernate.dialect.MySQL8Dialect,避免SQL生成的兼容问题 - 因为你的Spring Boot应用未做容器化部署,后续如果调整Docker网段配置导致网桥IP变动,反复手动匹配IP授权会大幅提升运维成本,在本地开发环境下开放
root@%的权限是更高效的选择。
内容的提问来源于stack exchange,提问作者Burak Dağlı
相关产品推荐
相关产品推荐

