宝塔面板安装mysql前必须检查三件事：一查/www/server剩余空间是否≥5gb，二查3306端口是否被占用，三清理残留mysql.sock文件；内存低于2gb时建议选mysql 5.7而非8.0。
宝塔面板里安装MySQL前必须检查的三件事
装不起来、装完起不来、装完连不上——八成问题出在安装前。别急着点“安装”，先确认这三项：
-
/www/server目录剩余空间是否 ≥5GB（df -h /www/server查）； - 执行
netstat -tlnp | grep 3306，确认端口未被其他进程占用； - 运行
find / -name mysql.sock -exec rm -f {} \;清理残留 socket 文件，避免因上次异常卸载导致新实例启动失败。
尤其注意：轻量服务器内存低于2GB时，MySQL 8.0 安装后大概率启动失败，建议降级选 MySQL 5.7。
安装后立刻要做的两件事：改root密码 + 关闭仅本地访问
宝塔生成的初始 root 密码强度极低，且默认只允许 localhost 连接。这两步跳过，后续远程连接或应用部署必然卡住。
- 进宝塔「数据库」页，点「root密码」按钮修改为高强度密码（含大小写字母、数字、符号）；
- 勾选「允许远程连接」——这一步实际执行的是
GRANT ... ON *.* TO 'root'@'%' IDENTIFIED BY 'xxx'; FLUSH PRIVILEGES;，不是单纯开个开关。
注意：允许远程连接 勾选后，宝塔会自动放行服务器防火墙的 3306 端口，但云服务商的安全组（如阿里云安全组、腾讯云访问控制）仍需手动开放该端口，否则外网依然连不上。
my.cnf 配置调优：轻量服务器别照搬默认值
宝塔安装的 MySQL 默认配置面向通用场景，对2核4G这类轻量服务器反而容易 OOM 或响应慢。关键改两项：
-
innodb_buffer_pool_size：设为可用内存的 50%～60%，例如 2GB 内存就写1G（不是1024M，单位必须是G或M）； -
max_connections：默认 151，轻量环境设为60即可，太高反而耗内存； - 别碰
sql-mode除非项目明确报错，CRMEB 类系统才需要改成NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION。
改完记得点宝塔 MySQL 设置页的「重载配置」，不要只重启服务——重载才会读新 my.cnf。
bash: mysql: command not found？这是PATH没加
宝塔装的 MySQL 二进制文件在 /www/server/mysql/bin，不在系统默认 PATH 里。所有命令行操作（比如 mysql -uroot -p）都会报这个错。
永久解决方法：编辑 /etc/profile，末尾加一行：
export PATH=/www/server/mysql/bin:$PATH
然后执行 source /etc/profile。验证：运行 which mysql 应返回 /www/server/mysql/bin/mysql。
别用软链接或临时 export，重启终端就失效；也别改 ~/.bashrc，宝塔后台任务走的是系统级 shell，认 /etc/profile。
