怎样在Debian系统中使用APT官方仓库平滑安装MySQL 8.0？-mysql教程-PHP中文网

必须先卸载mariadb并清空残留，否则mysql 8.0安装会因端口冲突、socket文件冲突或初始化失败而报错；debian 12默认源仅提供mariadb-server，执行apt install mysql-server实际安装的是mariadb而非mysql，官方mysql 8.0必须通过mysql-apt-config包切换apt源后才能安装。

怎样在debian系统中使用apt官方仓库平滑安装mysql 8.0？

必须先卸载 MariaDB 并清空残留，否则 MySQL 8.0 安装会卡在初始化或端口冲突上。

为什么 apt install mysql-server 不能直接装 MySQL 8.0？

Debian 12 默认源里压根没有 MySQL 8.0 的 mysql-server 包——它只提供 mariadb-server。你执行 apt install mysql-server 实际安装的仍是 MariaDB，只是包名伪装成 mysql。这不是版本低的问题，是根本不是同一个软件。

官方 MySQL 8.0 只能通过 Oracle 提供的 mysql-apt-config 包切换 APT 源后才能获取。跳过这步，后续所有操作都建立在错误前提上。

apt-cache policy mysql-server 输出里若没看到 8.0.xx-1debian12 这类候选版本，说明源没切对
即使装上了，mysql --version 显示的也常是 10.11.8-MariaDB，而非 mysql Ver 8.0.xx
服务名是 mariadb，systemctl 启动的是 mariadb.service，不是 mysql.service

卸载 MariaDB 必须 purge + 手动删文件

只用 apt remove 或 apt autoremove 不够，mysql-common 和 mariadb-common 这两个包会残留符号链接和配置模板，导致新 MySQL 安装时覆盖失败、mysql 命令仍指向旧二进制。

真正要执行的清理命令是：

sudo systemctl stop mariadb
sudo killall -u mysql 2>/dev/null || true
sudo apt purge mariadb-server mariadb-client mariadb-common mysql-common -y
sudo apt autoremove -y && sudo apt autoclean
sudo rm -rf /var/lib/mysql /etc/mysql /var/log/mysql /run/mysqld
sudo rm -f /etc/my.cnf /var/run/mysqld/mysqld.sock*
sudo userdel -r mysql 2>/dev/null

清理后务必验证：

dpkg -l | grep -i 'mariadb\|mysql' 应无输出
which mysqld 和 find / -name "mysqld" 2>/dev/null | head -3 应为空或只返回 /usr/bin/which: no mysqld in (...)
ss -tlnp | grep ':3306' 确保端口空闲

添加 MySQL 官方 APT 仓库的实操要点

下载的 mysql-apt-config 包必须匹配 Debian 12（代号 bookworm），但官方目前未单独发布 bookworm 专用包，实际可用 mysql-apt-config_0.8.36-1_all.deb（截至 2026 年 10 月最新版）。

MySQL

编写正确的MySQL查询，避免字符集、索引和锁方面的常见陷阱。

下载

安装时交互界面有陷阱：

用方向键选中 MySQL Server & Cluster → 按 Tab 切到 Ok → 回车；别直接回车，否则默认选的是 MySQL Server (Legacy)
进入子菜单后，必须手动将光标移到 mysql-8.0 行并按空格打勾，再 Tab 到 Ok
如果误选了 mysql-5.7 或留空，默认会启用旧通道，apt update 后仍看不到 8.0 版本

验证源是否生效：

sudo apt update
apt-cache policy mysql-server | grep "Candidate:"

输出应类似：Candidate: 8.0.37-1debian12

安装后立即要做的三件事

安装过程会弹出图形化密码设置界面（基于 debconf），输的密码就是 root@localhost 的初始密码。这个密码不能跳过，也不能留空——MySQL 8.0 不允许空密码初始化。

装完立刻执行：

sudo systemctl status mysql 确认服务已 active (running)，日志里没有 Can't create test file 或 Directory not empty 报错
sudo mysql_secure_installation：它会复用刚才设的 root 密码，但会强制要求改认证方式（见下条）
如果老客户端连不上，登录后立刻执行：ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';，否则 JDBC、DBeaver、Sequel Pro 等工具大概率报 caching_sha2_password 错误

最易被忽略的一点：MySQL 8.0 的 mysql_secure_installation 脚本默认不提供“跳过密码强度检查”选项，如果设的密码太简单（比如 123456），它会直接退出并提示 Password validation plugin is installed on the server —— 你得要么换强密码，要么先卸载插件，没有中间路径。