执行rails db:migrate报错：Mysql2::Error: root本地访问权限被拒

嘿，这个权限报错我碰到过好多次了，别慌，咱们一步步排查解决：

• 先核对 Rails 数据库配置文件
  打开项目里的 config/database.yml 文件，仔细检查对应环境（development/test/production）下的 username、password 和 host 配置是否正确。特别是 root 用户的密码，必须和你本地 MySQL 的 root 密码完全一致。举个正确的配置示例：

  development:
    adapter: mysql2
    database: your_app_development
    username: root
    password: your_actual_mysql_root_password
    host: localhost
    port: 3306
  

  注意别把密码写错，比如多打了空格或者大小写错误，这种小细节很容易踩坑。

• 验证 MySQL root 用户的本地登录权限
  直接在终端运行 mysql -u root -p，输入你认为正确的密码，看看能不能正常登录 MySQL。如果登不上，那问题出在 MySQL 本身，不是 Rails 的问题：

  • 如果你用的是 MySQL 8.0 及以上版本，可能是默认的认证插件不兼容 Rails 的 mysql2 驱动，登录 MySQL 后执行以下命令修改认证方式：

    ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_new_password';
    FLUSH PRIVILEGES;
    

  • 如果你用的是旧版本 MySQL，可能是 root 用户的权限不足，登录后执行：

    GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' IDENTIFIED BY 'your_password' WITH GRANT OPTION;
    FLUSH PRIVILEGES;
    

• 检查 MySQL 服务是否正常启动
  有时候服务没起来也会抛出类似的权限错误，很容易混淆：

  • Mac 系统（用 brew 安装的）：brew services start mysql
  • Linux 系统：sudo systemctl start mysqld
  • Windows 系统：打开「服务」面板，找到 MySQL 服务并启动

• 排查系统层面的限制（Linux 为主）
  如果是 Linux 服务器，可能是 SELinux 或者防火墙拦截了连接：

  • 临时关闭 SELinux 测试：sudo setenforce 0
  • 检查防火墙是否开放 3306 端口：sudo firewall-cmd --list-ports，如果没开放就添加：sudo firewall-cmd --add-port=3306/tcp --permanent && sudo firewall-cmd --reload

按照上面的步骤排查，基本就能解决这个权限问题啦。

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