树莓派上apt install mysql-server实际安装MariaDB而非MySQL 8.0，因Debian/Raspberry Pi OS已移除Oracle官方包；需修改/etc/mysql/mariadb.conf.d/50-server.cnf中bind-address并重启服务，配合%授权与mysql_native_password插件方可稳定远程访问。
mysql 在树莓派上直接部署官方 MySQL 8.0 几乎不可行，也不推荐 —— 当前 Raspberry Pi OS（基于 Debian 12/13）的 APT 源中已彻底移除 Oracle MySQL 的二进制包，apt install mysql-server 实际安装的是 mariadb-server-10.11（或更高），这是 Debian 和上游社区的明确策略。
你真正需要的不是“MySQL 8.0”，而是“能在树莓派上稳定运行、兼容 MySQL 协议、支持远程连接和物联网写入负载的关系型数据库”。MariaDB 就是那个答案，且它比 MySQL 8.0 更轻量、ARM 适配更成熟。
解析 MySQL 8.0 的 DDL 脚本，并将表结构导出为 Excel 格式。适用于用户需将 MySQL 的 `CREATE TABLE` 语句转换为结构化的 Excel 文件场景，导出内容包含字段名、数据类型、长度及精度等信息。支持多张表的批量处理，每张表对应 Excel 中的一个独立工作表。适用于数据库文档编写、数据字典生成及模式分析等任务。
为什么 apt install mysql-server 装不了 MySQL 8.0
这不是配置问题，是源层面的缺失：
- Debian 11+（含所有当前 Raspberry Pi OS 版本）已将 mysql-server 设为虚拟包，仅指向 mariadb-server；
- Oracle 官方不提供 ARM64 架构的 MySQL 8.0 DEB 包，手动下载 x86_64 包会报 cannot install on armhf/arm64；
- 强行从源码编译 MySQL 8.0 需要至少 4GB 交换空间 + 2 小时以上编译时间，且极易因 CMake 版本、Boost 库、SSL 依赖不匹配而失败；
- Docker 内编译同样面临相同依赖和资源瓶颈，还额外引入容器层开销。
bind-address 改在哪？50-server.cnf 是唯一生效位置
新手最常卡在这一步：改了 /etc/mysql/my.cnf 没用，服务重启后还是连不上。
原因：Raspberry Pi OS 使用分片式 MariaDB 配置，主监听配置在：/etc/mysql/mariadb.conf.d/50-server.cnf
必须编辑这个文件，找到这一行：
bind-address = 127.0.0.1
改为：
bind-address = 0.0.0.0
或直接注释掉（加 #）；
然后必须执行：sudo systemctl restart mariadb
仅 reload 不生效；
验证是否生效：sudo ss -tlnp | grep :3306
输出中应含 *:3306 或 0.0.0.0:3306，否则就是改错文件或没重启。
CREATE USER 和 GRANT 必须用 %，不能只用 IP
树莓派常接不同子网设备（手机热点、笔记本直连、路由器 DHCP 变动），用固定 IP 授权会频繁失效。
安全又实用的做法是：
- 创建专用用户，主机名用
'iot_user'@'%'（不是'iot_user'@'192.168.1.%'） - 授予权限时避免
GRANT ALL，最小权限原则：GRANT SELECT, INSERT, UPDATE ON iot_db.* TO 'iot_user'@'%'; - 务必执行
FLUSH PRIVILEGES;，否则权限不加载 - 别用 root 远程登录 ——
mysql_secure_installation中「禁止 root 远程登录」选Y，之后再建业务用户
Navicat 连接失败时先查 ERROR 2003 和 1045
这两个错误高频且含义清晰：
- ERROR 2003 (HY000): Can't connect to MySQL server → 网络层失败：要么 bind-address 没放开，要么防火墙拦了 3306（sudo ufw allow 3306），要么 Navicat 填错了树莓派局域网 IP；
- ERROR 1045 (28000): Access denied for user → 认证层失败：密码错、用户不存在、主机名不匹配（比如你建的是 'user'@'localhost' 却从远程连）、或认证插件不兼容（新 MariaDB 默认用 unix_socket 插件，root 本地可免密，但远程必须用 mysql_native_password）；
修复插件问题示例：ALTER USER 'iot_user'@'%' IDENTIFIED WITH mysql_native_password BY 'StrongPass123!';
实际部署中，最易被忽略的是配置文件路径的碎片化和权限插件的隐式切换 —— 它们不会报错，只会让连接静默失败。
