You need to enable JavaScript to run this app. Ubuntu环境下Spring Boot连接MySQL报root访问被拒绝问题解决
优惠活动
大模型
产品
解决方案
定价
更多

Ubuntu环境下Spring Boot连接MySQL报root访问被拒绝问题解决

问题根因

Ubuntu 环境下通过apt源安装的MySQL 8.x,默认对root账号启用auth_socket认证插件:该机制仅允许和系统用户名匹配的本地账号,通过系统socket权限校验完成连接,不支持基于密码的普通socket或TCP连接。
这也是为什么不带sudo执行mysql -u root、Spring Boot 直连数据库会触发访问拒绝错误;而带sudo执行命令时,当前执行命令的系统用户为root、通过了socket权限校验,才能正常进入MySQL交互shell。

解决方案

方案1:调整root账号认证规则,匹配现有Spring配置

  1. 通过sudo权限进入MySQL交互shell,执行命令:
    • sudo mysql -u root
  2. 切换到MySQL系统库,查询当前root账号的认证插件配置,执行SQL:
    USE mysql;
    SELECT user, host, plugin FROM user WHERE user = 'root';
    
    可看到root@localhost对应的插件值为auth_socket
  3. 将root账号的认证方式修改为mysql_native_password,匹配你当前配置里的空密码规则,执行SQL:
    ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '';
    

    如果需要给root设置独立密码,将上述语句中引号内的空值替换为实际密码即可

  4. 刷新权限配置使规则即时生效,执行SQL:
    FLUSH PRIVILEGES;
    
  5. 验证连通性:
    • 退出MySQL shell后,不带sudo直接执行mysql -u root,确认能正常登录
    • 重启Spring Boot项目,验证数据库连接是否正常建立

方案2:创建独立业务数据库账号(开发/生产推荐配置)

不建议直接开放root账号的密码连接权限,开发场景下使用独立账号更安全:

  1. 通过sudo mysql -u root进入MySQL shell
  2. 执行SQL完成库和账号的初始化配置:
    -- 确保tracking数据库存在,设置默认字符集
    CREATE DATABASE IF NOT EXISTS tracking DEFAULT CHARACTER SET utf8mb4;
    -- 创建业务专用账号,将语句中‘你的自定义密码’替换为实际使用的密码
    CREATE USER 'springboot'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的自定义密码';
    -- 给账号授予tracking库的全部操作权限
    GRANT ALL PRIVILEGES ON tracking.* TO 'springboot'@'localhost';
    -- 刷新权限使配置生效
    FLUSH PRIVILEGES;
    
  3. 修改项目.properties配置文件的数据库连接参数:
    • 将spring.datasource.username=root替换为刚创建的业务账号名
    • 将spring.datasource.password=的配置值替换为你给账号设置的实际密码
  4. 重启Spring Boot项目即可正常建立数据库连接
常见排查点
  • 修改配置后如果仍报访问拒绝,检查MySQL服务的绑定地址是否为localhost/127.0.0.1,未被错误配置为仅允许远程连接
  • 确认系统防火墙未拦截本地3306端口的连接请求
  • 检查MySQL配置文件中未开启skip-grant-tables的冲突认证配置

内容的提问来源于stack exchange,提问作者Kaumadie Prabashinie

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.25 10:45:06