常见原因是MySQL的bin目录未加入$PATH，需手动添加如/opt/homebrew/opt/mysql/bin或/usr/bin；若命令存在却不可用，应导出PATH并写入shell配置；注意Ubuntu可能默认安装MariaDB而非Oracle MySQL；登录失败多因认证插件不兼容或socket路径错误；建库须指定utf8mb4字符集，授权应创建专用用户而非直接用root。
用 brew 或 apt 安装 MySQL 后为什么 mysql 命令仍报 “command not found”
常见原因是安装后未将 MySQL 的 bin 目录加入 $PATH。macOS 用 brew install mysql 默认装在 /opt/homebrew/opt/mysql/bin/（Apple Silicon）或 /usr/local/opt/mysql/bin/（Intel），Ubuntu/Debian 则通常通过 apt install mysql-client mysql-server 安装，但客户端二进制可能在 /usr/bin/mysql，服务端在 /usr/sbin/mysqld。
验证是否已安装可执行文件：
ls -l /usr/bin/mysql /usr/local/bin/mysql /opt/homebrew/opt/mysql/bin/mysql 2>/dev/null
若存在但不可用，临时补路径：
export PATH="/opt/homebrew/opt/mysql/bin:$PATH"
永久生效需写入 shell 配置（如 ~/.zshrc 或 ~/.bashrc）。注意：某些 Linux 发行版（如 Ubuntu 22.04+）默认安装的是 mysql-shell 或 mariadb-client，运行 mysql --version 返回 “mysql Ver 15.1 Distrib 10.6.16-MariaDB” 就说明你实际连的是 MariaDB，不是 Oracle MySQL —— 大部分基础命令兼容，但高级特性（如角色管理、企业加密函数）不一致。
启动服务失败时检查 mysqld 是否真在运行，而非只靠 systemctl status mysql
systemctl status mysql 显示 “active (running)” 并不能保证 MySQL 实例已监听连接。常见假阳性：服务进程存在，但初始化失败、端口被占、数据目录权限错误，导致 mysql -u root -p 连不上。
排查步骤：
- 查真实监听状态：
sudo lsof -i :3306 | grep LISTEN
若无输出，说明 mysqld 没真正 bind 成功 - 看错误日志位置（Ubuntu 默认在
/var/log/mysql/error.log，macOS brew 在/opt/homebrew/var/mysql/*.err），直接 tail 最新行：sudo tail -n 20 /var/log/mysql/error.log
- 常见报错 “
Can't start server: Bind on TCP/IP port: Address already in use” 表示 3306 被占用，可用sudo ss -tulpn | grep :3306找出冲突进程 - 若提示 “
Failed to find valid data directory”，检查datadir配置（/etc/mysql/my.cnf或/opt/homebrew/etc/my.cnf）对应路径是否存在且属主为mysql用户
mysql -u root -p 登录失败：空密码、插件认证、socket 路径不对
MySQL 8.0+ 默认用 caching_sha2_password 插件，而旧客户端或某些 GUI 工具不支持，报错 “Plugin caching_sha2_password could not be loaded”。同时，macOS brew 安装后 root 默认无密码，但首次登录必须用 socket 方式（非 TCP），否则报 “Access denied for user 'root'@'localhost'”。
安全跳过密码登录（仅限本地调试）：
sudo /opt/homebrew/opt/mysql/bin/mysqld_safe --skip-grant-tables &
然后新开终端执行：
mysql -u root
进去后重置密码并改认证插件（MySQL 8.0+）：
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_new_password';
更稳妥的做法是初始化时就指定 socket 路径登录：
mysql -u root -S /opt/homebrew/var/mysql/mysql.sock
Linux 上常见 socket 路径是 /var/run/mysqld/mysqld.sock，可通过 mysql --help | grep "Default options" 查找配置文件读取顺序，再确认 socket 项值。
建库、授权、导入 SQL 文件的最小可靠操作链
别一上来就 CREATE DATABASE myapp;，先确认字符集和排序规则，否则中文存入乱码：
CREATE DATABASE myapp CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;
新建用户并授权（避免用 root 连应用）：
CREATE USER 'myapp_user'@'localhost' IDENTIFIED BY 'strong_password';
GRANT SELECT, INSERT, UPDATE, DELETE ON myapp.* TO 'myapp_user'@'localhost';
FLUSH PRIVILEGES;
导入已有 SQL 文件（确保文件内不含 CREATE DATABASE，否则会报错）：
mysql -u myapp_user -p myapp < /path/to/data.sql
注意：如果 SQL 文件里有 USE database_name;，而目标库名与命令行指定的不一致，会导入到错误库；若含 DROP TABLE 且表不存在，加 --force 参数忽略错误：
mysql -u myapp_user -p --force myapp < data.sql
最后别忘了关掉跳过权限验证的服务（如果之前启了 --skip-grant-tables），否则数据库完全裸奔。
