
作为后端开发、数据库学习的入门必备,MySQL 的环境配置是很多小伙伴的第一道 “小关卡”。尤其是不同 Linux 发行版(CentOS 7、Ubuntu)的安装步骤差异,再加上系统自带 MariaDB 的干扰、密码策略限制、中文编码等坑,很容易让人踩雷卡壳。 这篇博客就带来保姆级 MySQL 环境配置指南,不仅详细拆解 CentOS 7 下的完整安装步骤(从卸载冲突环境到配置优化),还补充了 Ubuntu 系统的安装流程,全程命令可直接复制,新手也能一步到位搞定 MySQL 环境,告别配置报错的烦恼!下面就让我们正式开始吧!
MySQL 被 Oracle 收购后,很多 Linux 发行版(比如 CentOS 7、Ubuntu)会默认预装MariaDB—— 它是 MySQL 的分支,语法兼容但底层有差异,会和官方 MySQL 产生端口、配置文件的冲突,因此安装 MySQL 前必须彻底卸载 MariaDB,这是配置成功的关键第一步!
本文中所有操作优先使用root用户执行(普通用户需加sudo获取权限),初期学习阶段建议直接用 MySQL root 用户操作,后续熟悉用户管理后再创建普通用户即可。
本次 CentOS 7 环境安装的是 MySQL 5.7 版本(兼容性强、学习常用),全程通过官方 YUM 源安装,稳定无第三方依赖问题,步骤分为卸载冲突环境→配置官方 YUM 源→安装 MySQL→初始化配置→优化设置五大环节。
首先查看系统中是否有 MariaDB 进程在运行,有则立即停止,避免卸载时出现资源占用报错:
# 检查MariaDB进程
ps ajx | grep mariadb
# 停止MariaDB服务
systemctl stop mariadb.service
# 再次检查,确认无相关进程
ps ajx | grep mariadb 通过rpm命令查询系统中已安装的 MariaDB/MySQL 相关包,然后逐一卸载:
# 查询MariaDB安装包
rpm -qa | grep mariadb
# 查询MySQL安装包(若有旧版)
rpm -qa | grep mysql
# 卸载MariaDB(替换为查询到的包名,也可直接批量卸载)
sudo yum remove mariadb -y
# 若有多个包,可直接通配符卸载
sudo yum remove mariadb* mysql* -y卸载前建议备份 MySQL/MariaDB 的配置文件和数据目录,防止误删重要内容:
# 备份配置文件
cp /etc/my.cnf /etc/my.cnf.bak
# 备份数据存储目录
cp -r /var/lib/mysql /var/lib/mysql.bakCentOS 7 默认 YUM 源中没有 MySQL 官方包,需要手动添加官方 YUM 源,建议安装和系统版本匹配的 MySQL 版本,避免兼容性问题。
确认 CentOS 7 的具体版本,保证后续下载的 YUM 源和系统匹配:
cat /etc/redhat-release 输出示例:CentOS Linux release 7.8.2003 (Core)
MySQL 官方 YUM 源地址:http://repo.mysql.com/,我们下载 MySQL 5.7 的 CentOS 7 专属 YUM 源包并安装:
# 下载MySQL 5.7 YUM源包
wget http://repo.mysql.com/mysql57-community-release-el7-10.noarch.rpm
# 安装YUM源(普通用户加sudo,解决权限问题)
sudo rpm -Uvh mysql57-community-release-el7-10.noarch.rpm 安装后会在/etc/yum.repos.d/目录下生成 mysql-community.repo 和 mysql-community-source.repo 两个文件,验证如下:
# 查看YUM源目录,确认出现MySQL相关repo文件
ls /etc/yum.repos.d/ | grep mysql确认 MySQL YUM 源可正常识别,执行如下命令查看可安装的 MySQL 包:
yum list | grep mysql 若输出中出现mysql-community-server等包,说明 YUM 源配置成功。
通过 YUM 源安装 MySQL 官方服务端和客户端,-y参数表示自动确认所有安装选项,无需手动回车:
sudo yum install -y mysql-community-server安装过程中会自动安装依赖包(mysql-community-common、mysql-community-libs、mysql-community-client),耐心等待即可。
常见坑 1:安装时出现秘钥过期报错,提示GPG Keys are configured as: file:///etc/pki/rpm-gpg/RPM-GPG-KEY-mysql
解决方案:导入最新的 MySQL 官方秘钥即可:
rpm --import https://repo.mysql.com/RPM-GPG-KEY-mysql-2022重新执行安装命令即可成功。
# 启动MySQL服务
systemctl start mysqld.service
# 设置开机自启(可选,建议开启,避免重启系统后服务失效)
systemctl enable mysqld
# 重载系统服务配置
systemctl daemon-reload通过进程查询确认 MySQL 服务正常启动:
ps axj | grep mysqld 若输出中出现/usr/sbin/mysqld相关进程,说明服务启动成功。
MySQL 5.7 安装后会自动生成临时 root 密码,存放在/var/log/mysqld.log日志文件中,必须先通过临时密码登录,再修改为自定义密码,以下提供 3 种登录方法,按顺序尝试即可。
# 从日志中提取临时root密码
sudo grep 'temporary password' /var/log/mysqld.log 输出示例:root@localhost: yLMalT:v+5l*(冒号后为临时密码,复制即可)
# 登录MySQL,输入上述临时密码
mysql -uroot -p密码策略限制:MySQL 5.7 默认开启密码强度验证,要求密码包含数字、符号、大小写字母,长度至少 8 位,新手可先关闭该策略,再设置简单密码:
-- 关闭密码强度验证策略(0为最低,1为中,2为高)
set global validate_password_policy=0;
-- 设置密码最小长度为1位
set global validate_password_length=1;
-- 修改root本地登录密码(替换为自己的密码,示例:qwer@wu.888)
ALTER USER 'root'@'localhost' IDENTIFIED BY 'qwer@wu.888';
-- 刷新权限,使配置生效
FLUSH PRIVILEGES;执行完成后,退出 MySQL 重新登录即可使用新密码。
若上述命令未提取到临时密码,说明安装的 MySQL 版本无初始密码,直接执行如下命令登录:
mysql -uroot -p出现密码输入框时直接回车,即可成功登录,后续按方法 1 修改密码即可。
若前两种方法均失败,可通过修改配置文件跳过 MySQL 权限验证,强制登录后重置密码:
# 编辑MySQL主配置文件
vim /etc/my.cnf 在[mysqld]节点最后添加如下配置,保存并退出(vim 中按i编辑,ESC+:wq保存):
# 跳过MySQL权限验证
skip-grant-tables# 重启MySQL服务,使配置生效
systemctl restart mysqld.service
# 直接登录,无需输入密码
mysql -uroot登录后执行如下 SQL 重置密码,重置后必须删除 skip-grant-tables 配置并重启服务,否则 MySQL 无权限验证,存在安全风险:
-- 切换到mysql系统库
USE mysql;
-- 重置root密码(替换为自己的密码)
UPDATE user SET authentication_string=PASSWORD('qwer@wu.888') WHERE User='root' AND Host='localhost';
-- 刷新权限
FLUSH PRIVILEGES;
-- 退出MySQL
exit;# 编辑配置文件,删除skip-grant-tables配置
vim /etc/my.cnf
# 重启MySQL服务
systemctl restart mysqld.service 默认的 MySQL 配置存在中文编码乱码、存储引擎未指定等问题,需要修改/etc/my.cnf配置文件,优化核心参数,本次配置UTF-8 编码和InnoDB 默认存储引擎(MySQL 主流存储引擎,支持事务、行锁)。
# 编辑配置文件
vim /etc/my.cnf按如下内容修改,保留原有配置,补充缺失项即可:
[mysql]
# 客户端编码(暂不设置,避免MySQL汉字回显bug,可后续根据需求开启)
# default-character-set=utf8
[mysqld]
# MySQL端口,默认3306
port=3306
# 数据存储目录
datadir=/var/lib/mysql
# 套接字文件
socket=/var/lib/mysql/mysql.sock
# 禁用符号链接,防止安全风险
symbolic-links=0
# 日志文件路径
log-error=/var/log/mysqld.log
# 进程文件路径
pid-file=/var/run/mysqld/mysqld.pid
# 服务端编码,UTF-8
character-set-server=utf8
# 默认存储引擎InnoDB
default-storage-engine=innodb
# InnoDB缓冲池大小,根据服务器内存调整,专用服务器设为内存70%,普通服务器10%
# innodb_buffer_pool_size = 128M修改完成后,重启 MySQL 服务使配置生效:
systemctl restart mysqld.service原因:终端本身不支持 UTF-8 编码,而非 MySQL 配置问题。
解决方案:检查终端 LANG 环境变量,确保为 UTF-8 编码:
# 查看LANG变量
env | grep LANG 若输出不是LANG=en_US.utf8,则修改终端编码(永久生效需修改/etc/profile文件):
# 临时设置UTF-8编码
export LANG=en_US.utf8
# 永久设置,编辑profile文件
echo "export LANG=en_US.utf8" >> /etc/profile
# 使配置生效
source /etc/profile排查思路:查看 MySQL 错误日志,定位具体失败原因:
# 查看错误日志最后100行
tail -100 /var/log/mysqld.log常见原因:端口 3306 被占用、数据目录权限不足、配置文件语法错误,对应解决即可。
Ubuntu 系统(以 20.04/22.04 为例)安装 MySQL 和 CentOS 7 差异较大,Ubuntu 使用apt包管理器,且默认预装的 MariaDB 处理方式更简单,本次安装 MySQL 8.0 版本(Ubuntu 官方源中主流版本),步骤分为卸载 MariaDB→更新 apt 源→安装 MySQL→初始化配置→远程访问配置。
# 停止MariaDB服务
sudo systemctl stop mariadb
# 卸载MariaDB所有包
sudo apt remove mariadb-server mariadb-client mariadb-common -y
# 清理残留配置文件
sudo apt autoremove -y
sudo apt clean Ubuntu 默认 apt 源包含 MySQL 官方包,直接更新源后安装即可,推荐安装mysql-server(包含服务端 + 客户端 + 依赖):
# 更新apt软件源
sudo apt update && sudo apt upgrade -y
# 安装MySQL服务
sudo apt install mysql-server -y 安装过程中无需手动设置密码,Ubuntu 的 MySQL 会自动创建 root 用户并采用auth_socket认证方式(仅本地 root 用户可登录,无需密码)。
# 查看MySQL服务状态
sudo systemctl status mysql
# 设置开机自启
sudo systemctl enable mysql 若输出中显示active (running),说明服务启动成功。
Ubuntu 安装的 MySQL 默认不允许密码登录,需要先修改认证方式为mysql_native_password,再设置密码,步骤如下:
# 以root身份登录MySQL(Ubuntu本地免密)
sudo mysql -uroot执行如下 SQL 语句,修改 root 密码并更改认证方式:
-- 切换到mysql系统库
USE mysql;
-- 修改root认证方式为密码认证,设置密码(替换为自己的密码)
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'MySql@123456';
-- 刷新权限
FLUSH PRIVILEGES;
-- 退出MySQL
exit;修改完成后,即可通过密码正常登录:
mysql -uroot -p输入设置的密码,即可成功登录。
Ubuntu 的 MySQL 主配置文件为/etc/mysql/mysql.conf.d/mysqld.cnf,编辑该文件优化编码和核心参数:
# 编辑配置文件
sudo vim /etc/mysql/mysql.conf.d/mysqld.cnf 在[mysqld]节点添加 / 修改如下配置:
# 服务端编码
character-set-server = utf8mb4
# 排序规则
collation-server = utf8mb4_unicode_ci
# 默认存储引擎
default-storage-engine = InnoDB
# 端口
port = 3306
# 允许远程访问(注释掉bind-address,默认绑定127.0.0.1,仅本地可访问)
# bind-address = 127.0.0.1# 编辑客户端配置文件,设置客户端编码
sudo vim /etc/mysql/conf.d/mysql.cnf 在[mysql]节点添加:
default-character-set = utf8mb4修改完成后,重启 MySQL 服务:
sudo systemctl restart mysql验证编码配置是否生效:
-- 登录MySQL后执行
SHOW VARIABLES LIKE '%character%';
SHOW VARIABLES LIKE '%collation%'; 若所有编码项均为utf8mb4,说明配置成功(utf8mb4是 UTF-8 的超集,支持 emoji 和特殊中文)。
默认情况下 MySQL 仅允许本地访问,若需要在其他机器上连接 Ubuntu 的 MySQL,需完成配置文件修改 + 权限授权 + 防火墙开放三步,前文已注释掉bind-address,接下来授权远程访问并开放 3306 端口:
mysql -uroot -p-- 授权root用户从任意IP访问(%表示任意IP,可替换为具体IP,如192.168.1.100)
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY 'MySql@123456' WITH GRANT OPTION;
-- 刷新权限
FLUSH PRIVILEGES;
exit;Ubuntu 默认使用 ufw 防火墙,开放 3306 端口(TCP 协议,MySQL 默认端口):
# 查看防火墙状态
sudo ufw status
# 开放3306/TCP端口
sudo ufw allow 3306/tcp
# 重启防火墙
sudo ufw reload完成后,即可在本地通过 Navicat、DataGrip 等工具,输入 Ubuntu 服务器 IP、3306 端口、root 账号密码连接 MySQL。
MySQL 的环境配置是基础,掌握不同系统的安装方法,能快速适配各种开发环境。后续可以继续学习 MySQL 的用户管理、数据库设计、SQL 语句优化等内容,打好后端开发的数据库基础。 如果配置过程中遇到其他报错,欢迎在评论区留言,我会第一时间解答!觉得这篇教程有用的话,记得点赞 + 收藏哦~