树莓派无法直接安装原生mysql 8.0，因为raspberry pi os（基于debian 11+）已将mysql-server设为指向mariadb-server的虚拟包，且oracle官方未提供arm架构预编译包；正确做法是安装mariadb-server-10.11.x，它完全兼容mysql 8.0语法、协议与工具，并通过mysql_secure_installation配置安全选项及认证方式。
树莓派上装不了原生 MySQL 8.0，apt install mysql-server 实际安装的是 mariadb-server-10.11.x —— 这不是 bug，是 Debian 和 Raspberry Pi OS 的明确设计。硬要强装 Oracle 官方 MySQL 8.0，大概率卡在 ARM 架构编译失败、依赖冲突或 mysqld 启动报错（比如 Illegal instruction）。
为什么树莓派不能直接 apt 装 MySQL 8.0
Debian 11+（含当前 Raspberry Pi OS）已将 mysql-server 设为虚拟包，指向 mariadb-server。Oracle MySQL 官方不提供 ARM64/ARMHF 的预编译二进制包，其 APT 仓库只支持 x86_64。你执行 sudo apt install mysql-server 时，APT 会明确提示：
Package mysql-server is a virtual package. You should install one of the following packages: mariadb-server
强行下载 x86_64 的 .deb 或 .tar.xz 并用 dpkg --force-architecture 强装，会导致 mysqld 运行时因指令集不兼容而崩溃。
如何正确部署“MySQL 8.0 兼容环境”
MariaDB 10.11+ 已完全兼容 MySQL 8.0 的核心行为，包括：
-
utf8mb4_0900_as_cs排序规则支持（需手动启用） - 窗口函数、CTE、JSON_TABLE 等语法一致
-
mysql命令行客户端、mysqldump、连接协议（3306）、权限模型完全互通 - Navicat、DBeaver、Python
pymysql/mysql-connector-python等工具无需任何适配
实操步骤只需三步：
1. 执行 sudo apt update && sudo apt install mariadb-server
2. 运行 sudo mysql_secure_installation（别用 mysqladmin -u root password，它会绕过认证插件导致后续登录失败）
3. 若需远程访问：编辑 /etc/mysql/mariadb.conf.d/50-server.cnf，注释掉 bind-address = 127.0.0.1，再执行 sudo systemctl restart mariadb
远程连接失败的典型原因和验证方法
常见错误：ERROR 2003 (HY000): Can't connect to MySQL server 或 Navicat 报 “Connection refused”
排查顺序必须是：
- 确认服务在运行：
sudo systemctl is-active mariadb（应返回active） - 确认监听地址：
sudo ss -tlnp | grep :3306，输出中必须含*:3306或0.0.0.0:3306；若只有127.0.0.1:3306，说明配置没生效或改错了文件 - 确认防火墙放行：
sudo ufw status，确保3306在允许列表里（树莓派默认未启用 ufw，但若你启用了就得加规则） - 确认用户授权：
mysql -u root -p -e "SELECT host,user FROM mysql.user;"，远程用户必须有@'%'或@'192.168.%'这类非localhost的 host
真正容易被忽略的是：MariaDB 默认启用 unix_socket 插件接管 root 登录，导致 mysql -u root -p 失败，但 sudo mysql 可直连——这不是密码错了，是认证机制不同。所以安全初始化必须走 mysql_secure_installation，它会自动切换 root 的认证方式并设密码。
