这份 MySQL 安装指南 升级成一个更全面、更方便查阅,不仅包含安装,还加上命令速查表、安全加固步骤和常见错误排查表。
MySQL 安装与排错全指南(优化版)
本文以 MySQL 8.0 为例,适用于 Windows、macOS、Linux 多平台,涵盖安装、初始化、安全加固、常见问题排查等内容。
一、快速命令索引表
系统 | 安装命令 | 启动命令 | 停止命令 | 状态查看 |
Ubuntu/Debian | sudo apt install mysql-server | sudo systemctl start mysql | sudo systemctl stop mysql | sudo systemctl status mysql |
CentOS/RHEL | sudo yum install mysql-community-server | sudo systemctl start mysqld | sudo systemctl stop mysqld | sudo systemctl status mysqld |
macOS (Homebrew) | brew install mysql | brew services start mysql | brew services stop mysql | brew services list |
Windows (Installer) | 图形化安装 | 服务管理器 | 服务管理器 | 服务管理器 |
Windows (ZIP) | 手动解压 | net start mysql | net stop mysql | sc query mysql |
二、安装 MySQL
1. Windows 系统
方法一:MySQL Installer(推荐)
- 下载 MySQL Installer
- 运行安装向导:
- Developer Default(包含 MySQL Server、Workbench、工具包)
- 设置 root 密码、认证方式(推荐:强密码)
- 配置为 开机自启
- 完成安装,可用 MySQL Workbench 或命令行连接。
方法二:ZIP 压缩包
# 初始化数据目录
mysqld --initialize --console
# 安装服务
mysqld --install
# 启动服务
net start mysql
2. macOS 系统
方法一:Homebrew(推荐)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install mysql
brew services start mysql
mysql_secure_installation
方法二:DMG 安装包
- 从官网下载安装包,双击安装
- 在「系统偏好设置」管理 MySQL 服务
3. Linux 系统
Ubuntu/Debian
sudo apt update
sudo apt install mysql-server
sudo mysql_secure_installation
CentOS/RHEL
sudo rpm -Uvh https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm
sudo yum install mysql-community-server
sudo systemctl start mysqld
sudo grep 'temporary password' /var/log/mysqld.log
sudo mysql_secure_installation
三、安全加固建议
运行安全初始化:
sudo mysql_secure_installation
# 建议选择:
# Remove anonymous users? (Y)
# Disallow root login remotely? (Y)
# Remove test database? (Y)
# Reload privilege tables now? (Y)
配置 my.cnf:
[mysqld]
bind-address = 127.0.0.1 # 限制远程访问
skip-name-resolve # 禁止 DNS 反解析,提高连接速度
四、常用操作
-- 创建用户
CREATE USER 'user'@'localhost' IDENTIFIED BY 'password';
-- 授权
GRANT ALL PRIVILEGES ON *.* TO 'user'@'localhost';
FLUSH PRIVILEGES;
-- 创建数据库
CREATE DATABASE dbname;
-- 修改密码
ALTER USER 'root'@'localhost' IDENTIFIED BY 'new_password';
五、常见问题排查
问题 | 可能原因 | 解决方法 |
无法连接 MySQL | 1. 服务未启动2. 防火墙阻止3. bind-address 限制 | systemctl start mysql,检查防火墙和配置 |
忘记 root 密码 | 密码丢失 | --skip-grant-tables 启动 MySQL 修改密码 |
端口冲突 | 3306 被占用 | 修改 my.cnf 的 port 配置 |
启动失败 | 数据目录权限 / 配置错误 | 查看日志(见下)修正 |
慢查询 | SQL 优化不足 | 启用 slow_query_log 记录慢查询 |
六、日志路径
- Ubuntu/Debian:/var/log/mysql/error.log
- CentOS/RHEL:/var/log/mysqld.log
- macOS (brew):/usr/local/var/mysql/*.err
- Windows:C:\ProgramData\MySQL\MySQL Server x.x\Data\hostname.err
七、推荐管理工具
- MySQL Workbench(官方 GUI)
- phpMyAdmin(Web 管理)
- DBeaver(跨平台通用工具)
- HeidiSQL(轻量级)
八、一键初始化脚本(Linux 示例)
#!/bin/bash
sudo apt update
sudo apt install -y mysql-server
sudo systemctl enable mysql --now
sudo mysql_secure_installation <<EOF
y
n
y
y
y
EOF
echo "MySQL 安装完成,已启用安全配置"