在 Ubuntu 上折腾 MySQL从我踩过的坑说起如果你现在正准备在自己的 Ubuntu 机器上装一份 MySQL我建议先别急着复制粘贴命令而是花五分钟把下面这篇东西看完。我在 Ubuntu 18.04、20.04、22.04 上都部署过 MySQL也帮朋友处理过各种五花八门的报错从mysql_secure_installation卡住到 Navicat 死活连不上再到 SSL 连接直接给你一个令人绝望的错误码基本都经历过一遍。这篇博文就是一份“实操日志”把我在 Ubuntu 环境下装 MySQL、配置 MySQL、连接 MySQL 的完整过程连同那些文档里不会写清楚的经验教训一次性拿出来分享。这个内容适合谁其实覆盖挺广的——刚学 Linux 的学生、做 JavaWeb 课程设计要搭数据库的开发者、以及准备把生产环境切到 Ubuntu 服务器的运维朋友都能从中找到对应的章节。我会从环境准备开始逐步拆解安装方式的选择、核心配置的细节、客户端连接的各种姿势最后把高频问题集中到一个速查表里。你把这篇当作一份“速查手册”也好当作“避坑指南”也好只要按着走大概率能少折腾几个小时。1. 环境准备与安装方案选型1.1 为什么 Ubuntu 是 MySQL 的舒适区先聊聊为什么在这里只用 Ubuntu 说事。MySQL 官方对 Ubuntu 的支持力度在社区版里算是比较高的尤其是 LTS 版本。Ubuntu 的 apt 仓库里直接就有 MySQL 的软件包这意味着你可以用一套非常朴素的方式完成安装apt install mysql-server系统会帮你处理大部分依赖关系。相比之下CentOS 或者 RHEL 上默认装的是 MariaDB想装官方 MySQL 还得先搞定仓库配置步骤会多一些。Ubuntu 的包管理器虽然偶尔也会有一些小脾气但整体上比 RPM 系要省心不少。还有一个现实的原因现在很多个人开发者和学生用的都是 Ubuntu 桌面版或虚拟机里的 Ubuntu Server网上折腾教程也集中在 Ubuntu 生态里。你在搜索引擎里看到的“mysql安装教程”十个里面有八个是在 Ubuntu 上演示的。所以我这篇也顺着这个主流路线来写保证你在跟着操作的时候不会遇到“为什么他的界面和我的不一样”这种困惑。1.2 两种安装方式apt 安装与源码编译在 Ubuntu 上装 MySQL主流方案就两个方式优点缺点适合场景apt 安装快速、依赖自动处理、升级方便版本可能不是最新受发行版源影响绝大多数情况强烈推荐官方仓库安装可以获得最新社区版保持官方维护节奏需要额外添加仓库、信任 GPG 密钥需要特定新版本或者生产环境源码编译安装可定制编译参数、安装路径过程漫长、依赖复杂、升级麻烦特殊硬件或定制需求一般人不建议我这里优先写 apt 安装因为它是“最不容易出错”的路线。如果你非要追求 8.0.44 这种具体的版本号或者想装到自定义目录那再考虑官方仓库或源码编译。需要提醒的是源码编译 MySQL 真的是一个时间黑洞——你不仅要装 cmake、gcc、boost 库还要担心编译到一半内存不够尤其是虚拟机里分配的内存偏小的时候。除非你有明确的定制化需求否则别自讨苦吃。1.3 安装前的系统准备与软件源优化动手安装之前有两件小事值得先做。第一步更新系统软件包索引。别小看这一步很多人在新装的 Ubuntu 上直接apt install mysql-server然后看到一堆依赖错误其实只是因为索引过期了。执行sudo apt update sudo apt upgrade -yupgrade不是必须的但如果你的系统特别新或者特别旧先升级一波基础组件能减少很多莫名其妙的兼容问题。不过升级之后建议重启一下再继续否则有些内核模块或 libc 库更新后当前会话尚未完全生效。第二步检查软件源是否可用。国内网络环境下默认的archive.ubuntu.com源经常慢得像蜗牛特别影响apt update的速度。如果你发现apt update卡住或者大量失败可以考虑换用阿里云、清华等镜像源。修改源的配置文件在/etc/apt/sources.list或者/etc/apt/sources.list.d/目录下把路径里的域名替换成镜像地址即可。这个操作网上一搜一大把但我要提醒一句换源之后务必再执行一次sudo apt update否则源列表和软件包索引不对应会直接导致后续安装失败。注意如果你是在虚拟机里装 Ubuntu内存小于 1.5GB 的话MySQL 8.0 启动时会比较吃力。建议给虚拟机分配 2GB 以上的内存否则后面systemctl start mysql可能会卡住查看日志还会看到一堆InnoDB: Operating system error number 12之类的内存分配失败信息。2. 核心配置与初始化实战2.1 服务管理与初始安全设置安装完成后MySQL 服务通常会自动启动。但为了保险建议手动确认一下sudo systemctl status mysql如果没在运行就用sudo systemctl start mysql拉起它。这里有个 Ubuntu 特有小细节有些版本的服务名是mysql有些是mysqld还有mariadb的情况。如果systemctl status mysql提示找不到服务可以先执行sudo systemctl list-units | grep -i sql看看实际的服务名。肉眼排查最快。接下来是重头戏运行sudo mysql_secure_installation。这个交互式脚本会引导你完成 root 密码设置、删除匿名用户、禁止 root 远程登录、删除 test 数据库、刷新权限表等操作。很多人卡在这一步是因为在 Ubuntu 上安装 MySQL 8.0 后root 用户默认使用的是auth_socket认证插件而不是密码认证。所以在提示输密码的时候你直接按回车也能进去因为当前系统用户sudo的身份就是被允许的。如果你之前没用sudo进入而是直接mysql -u root -p那会报Access denied因为 root 的密码还没设置。我第一次在 Ubuntu 上装 MySQL 时就搞糊涂了后来记住了一个铁律装完 MySQL 之后第一步永远是sudo mysql进入而不是mysql -u root -p。进入之后你可以手动修改 root 的认证方式ALTER USER rootlocalhost IDENTIFIED WITH caching_sha2_password BY 你的新密码; FLUSH PRIVILEGES;mysql_secure_installation脚本会帮你完成这些操作的大部分但如果你希望 root 也可以通过密码登录就需要手动调整认证插件。这里还需要注意 MySQL 8.0 默认的密码认证插件是caching_sha2_password如果你的客户端工具版本太老比如有些老版本的 Navicat可能不支持这种插件后面连接会报错。解决方案有两个一是升级客户端工具二是把用户的认证插件改回mysql_native_passwordALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的新密码;2.2 字符集、排序规则与时区配置这是我最想强调的部分。很多人装好 MySQL 后没有把默认字符集改成utf8mb4结果插入中文数据或者表情符号时直接报错或者出现乱码。用一个不那么严谨但很好记的话来说utf8mb4是完整的 UTF-8而utf8/utf8mb3是阉割版不支持一些特殊字符和 emoji。MySQL 8.0 的默认字符集其实已经是utf8mb4了但排序规则可能不是你想要的。为了保险我还是建议在配置文件里显式声明[mysqld] character-set-server utf8mb4 collation-server utf8mb4_0900_ai_ci上面的排序规则utf8mb4_0900_ai_ci是 MySQL 8.0 的默认选项大小写不敏感适合大多数场景。如果你的数据里有中文排序需求可能还需要额外考虑utf8mb4_zh_0900_as_cs之类的选项不过这个可以先不折腾。修改配置文件后重启服务sudo systemctl restart mysql重启后登录 MySQL执行SHOW VARIABLES LIKE character_set%;查看值是否生效。如果全是utf8mb4那是最好如果有latin1之类的残留说明配置文件可能没读对或者[mysqld]段写到了无效位置。时区设置也建议顺手确认一下。MySQL 默认时区通常是系统时区但有时候会是 UTC这会导致NOW()函数返回的时间和你本地时间差好几个小时。临时查看SELECT NOW();如果发现时间不对可以在配置文件的[mysqld]段加一行default-time-zone 08:00不过更优雅的做法是让 MySQL 直接读取系统时区sudo systemctl restart mysql mysql -e SET GLOBAL time_zone SYSTEM;这里要提醒一点SET GLOBAL只对本次运行有效重启后依然恢复原状。所以最好还是写进配置文件。2.3 用户授权与远程访问本地使用 MySQL 没问题之后很多人会遇到下一个需求用 Navicat 或者其他工具从 Windows 主机连接 Ubuntu 虚拟机里的 MySQL。这时候涉及三个层面的设置缺一不可。第一MySQL 用户必须允许从外部主机连接。默认的 root 用户通常被限制在localhost即使你把它改成密码认证Mysql 的user表里 Host 还是localhost。你需要新建一个用户或者修改 root 的 HostCREATE USER dev% IDENTIFIED BY 强密码; GRANT ALL PRIVILEGES ON *.* TO dev%; FLUSH PRIVILEGES;%表示允许任意主机连接。如果你只想让某一台机器连就把%换成对应的 IP安全性更好。第二MySQL 的监听地址必须是0.0.0.0而不是默认的127.0.0.1。这个设置在配置文件里bind-address 0.0.0.0改完同样要重启服务。如果你发现远程还是连不上先执行ss -tlnp | grep 3306看看 MySQL 实际监听在哪个地址上。这里有个很容易踩的坑Ubuntu 20.04 之后有些版本的 MySQL 会默认跳过网络监听skip-networking你需要检查配置文件确认这个选项没有被打开。第三防火墙得放行 3306 端口。Ubuntu 桌面版的防火墙默认是未启用的但服务器版或者你手动装了ufw的话就要执行sudo ufw allow 3306/tcp注意远程连接时密码中的特殊字符在连接参数里要注意转义。我记得有一次帮同事排错他的密码里含有一个符号然后在连接串里写user:passwordhost结果密码被截断了一直报认证失败。后来我让他用带引号的 URL 格式才解决。3. 客户端连接与工具链实用指南3.1 命令行操作与常用查询命令行永远是第一线的操作方式。进 MySQL 的命令有两种姿势sudo mysql mysql -u 用户名 -p在 Ubuntu 上sudo之后一般不再需要密码就能用 root 身份进库这是 MySQL 8.0 配合 Ubuntu 的默认行为。进入之后日常操作基本就是增删改查加结构管理。我建议你先把这几个命令烂熟于心SHOW DATABASES; USE 数据库名; SHOW TABLES; DESCRIBE 表名; SELECT VERSION();快速查看当前实例状态SHOW STATUS LIKE Uptime; SHOW VARIABLES LIKE max_connections;如果你在写 JavaWeb 项目经常要手动往库里灌数据我建议把常用的插入语句和查询语句存到一个.sql文件里然后用mysql -u 用户 -p 文件.sql批量执行比一条条复制粘贴快得多。3.2 图形化工具选择Navicat 与 MySQL Workbench命令行归命令行但大多数人还是喜欢图形界面操作。这里简单说一下两种主流工具。Navicat 是最常见的商业工具功能强界面漂亮但版本五花八门。在 Ubuntu 上连 MySQL要注意两点一是连接配置里选好 SSH 隧道的选项如果你是通过跳板机访问二是认证插件的问题刚才说的caching_sha2_password在某些旧版 Navicat 里无法使用最直观的表现就是“连接成功但读取数据失败”或者直接报连接错误。遇到这个问题优先升级 Navicat其次才是把 MySQL 用户的认证插件改成mysql_native_password。MySQL Workbench 是官方免费工具跨平台用来做数据库建模和查询都很顺手。Ubuntu 下安装可直接sudo apt install mysql-workbench-community不过在 22.04 上可能没有最新版需要去官网下载。我的个人经验是如果你只是做课程设计或者小项目用 Workbench 完全够用没必要去折腾 Navicat 的破解版。3.3 编程语言连接Python 与 Docker 场景用 Python 连接 MySQL 是另一个高频场景。无论你是写爬虫还是跑数据分析都要处理数据库连接。最常用的库是pymysql纯 Python 实现安装方便pip install pymysql连接示例import pymysql conn pymysql.connect( hostlocalhost, userdev, passwordyour_password, databasetest, charsetutf8mb4 ) cursor conn.cursor() cursor.execute(SELECT * FROM user) rows cursor.fetchall() print(rows)如果你是用 Docker 跑 Python 应用那就更需要留意 MySQL 的网络模式了。常见的做法是让容器和应用共享一个网络或者直接用宿主机 IP 访问 MySQL。我之前写过一篇在 Ubuntu 上装 Docker 并跑 Python 环境的文章里面强调过一个关键点Docker 容器里的localhost只指向容器自身访问宿主机的 MySQL 必须用host.docker.internal或者宿主机 IP。这个问题在开发阶段最容易坑人连接报错时先检查地址对不对再看权限和防火墙。3.4 SSL 连接错误与安全传输MySQL 连接时还常遇到 SSL 相关报错比如SSL connection error: error:1425F102这种。这通常是因为客户端与服务器之间的 SSL 版本或证书策略不匹配。MySQL 8.0 默认开启 SSL 支持如果你只是本地开发完全不介意数据明文传输可以显式关闭 SSL在客户端连接串中加?ssl-modeDISABLED或者以编程方式连接时加ssl_disabledTrue。在mysql命令行客户端里连接时指定--ssl-modeDISABLED可以跳过。如果服务端想彻底关闭 SSL可以在配置文件里[mysqld] ssl0不过我不建议生产环境这么干。生产环境最好还是配置受信任的证书或者至少使用REQUIRE SSL来保证连接加密。我在 Ubuntu 上遇到 SSL 错误多半是客户端版本太老、无法解析新服务器的证书链导致的先把客户端升级到和服务器版本同一代是通用解法。4. 常见问题与排查技巧实录4.1 忘记 root 密码的处理方案这个场景太常见了尤其是你在 Ubuntu 上装好 MySQL 之后过了一个月再去用死活想不起密码。别慌有一招能“无密码”进入数据库首先停止服务sudo systemctl stop mysql然后以安全模式启动 MySQL跳过授权表sudo mysqld_safe --skip-grant-tables 但注意mysqld_safe启动后是后台运行你要确保原服务已经停止避免端口冲突。启动后直接进入mysql -u root进去后立刻执行FLUSH PRIVILEGES; ALTER USER rootlocalhost IDENTIFIED WITH caching_sha2_password BY 新密码;改完之后重启服务用新密码登录。这个方法我一直都在用需要注意的点在于--skip-grant-tables模式下任何用户都能直接进入所以千万不能让它长时间运行改完密码立刻重启恢复原样。4.2 环境变量配置错误与修复另一类经典问题出现在你把 MySQL 的bin目录加到 PATH 后发现自己改错了/etc/environment或者~/.bashrc然后重启后命令找不到了。比如你执行了export PATH/usr/bin但把原有路径覆盖了可能连ls都使不了。遇到这种情况可以用绝对路径临时补救/usr/bin/less /etc/environment或者用sudo修正。修复~/.bashrc的要点是不要追加覆盖而是在文件末尾追加导出语句echo export PATH$PATH:/usr/local/mysql/bin ~/.bashrc source ~/.bashrc注意顺序$PATH一定要保留否则会把系统原有命令路径丢光。这个坑我见过很多次很多人为了让mysql命令全局可用直接写export PATH/usr/local/mysql/bin然后整个世界都崩了。4.3 安装过程中的依赖与权限问题有时候apt install mysql-server会提示依赖关系无法解决比如缺少libaio1、libncurses5之类的包。这种情况多发生在较新版本的 Ubuntu 上因为某些老库被移出了默认源。对付依赖问题的思路是先执行sudo apt --fix-broken install让系统自动尝试修复。如果还报错可以手动安装缺失的包。比如sudo apt install libaio1t64或libncurses5。实在不行直接去 Ubuntu 包仓库搜索对应包下载.deb文件离线安装。关于权限问题安装完 MySQL 后/var/lib/mysql目录的所有者必须是mysql:mysql。如果之前在非正常状态下启动过目录权限可能变了导致服务起不来。修复方法sudo chown -R mysql:mysql /var/lib/mysql sudo chmod -R 750 /var/lib/mysql4.4 连接被拒绝与端口问题最后一个常见问题也是排查优先级最高的Cant connect to MySQL server on x.x.x.x。按顺序检查三件事MySQL 是否真的在监听。执行sudo ss -tlnp | grep 3306没有输出说明服务没启动或者配置不对。防火墙是否拦截。Ubuntu 下先sudo ufw status查看然后确认 3306 放行。用户权限和 Host 是否允许你的客户端 IP。这个在 MySQL 里执行SELECT host, user FROM mysql.user;查看。如果以上都没问题再看是否有 SELinux。Ubuntu 默认没有装 SELinux但如果你装了需要关掉对 mysqld 的限制。我在 Ubuntu 上碰到的“远程连不上”问题八成以上都是用户 Host 没匹配上或者 bind-address 没改。4.5 常见问题速查表问题快速解决办法Cant connect to local MySQL server确认服务已启动sudo systemctl start mysqlAccess denied for user rootlocalhost执行sudo mysql后改密码SSL connection error客户端升级或连接参数加ssl-modeDISABLED远程连接失败检查 bind-address、防火墙、用户 HostHost 字符集乱码配置character-set-serverutf8mb4安装依赖报错先apt --fix-broken install再手动装缺失包Docker 连接宿主机 MySQL使用host.docker.internal或宿主机 IPTable doesnt exist但明明有检查大小写敏感设置lower_case_table_names最后再分享一个我自己的习惯每次在 Ubuntu 上装完 MySQL我都会立刻执行一组“体检命令”——SELECT VERSION();、SHOW VARIABLES LIKE character_set%;、SHOW VARIABLES LIKE port;、SELECT NOW();五秒钟内确认版本、字符集、端口、时区都正常再继续往下干活。这个习惯帮我省了无数次回头排查的时间。如果你按着这篇博文走完了全程我建议你也把这一组命令存进笔记里遇到诡异问题时先跑一遍基本能定位八成以上的故障。