必须用arm原生mysql包：uname -m输出aarch64才兼容官方8.0.28+ arm64包；armv7l设备应改用mariadb；docker需显式指定--platform=linux/arm64或使用-arm64v8镜像。
直接在 ARM 服务器上运行 x86 编译的 MySQL 二进制文件会报 Exec format error，这不是配置问题，是根本跑不起来。必须用 ARM 原生构建或部署方式。
确认目标平台架构类型，避免误判 armv7l 和 aarch64
很多故障根源是没分清设备真实架构。树莓派 4B、鲲鹏、飞腾、苹果 M 系列芯片都属于 aarch64；而树莓派 3B、旧款 Orange Pi 则是 armv7l，后者无法运行官方 MySQL ARM64 包。
执行以下命令验证：
-
uname -m—— 输出aarch64才能用 MySQL 8.0.28+ 官方 ARM64 包 -
file /bin/bash—— 确认系统本身是 ARM64 可执行格式 -
lscpu | grep "Architecture"—— 辅助交叉验证
若结果为 armv7l，别硬试 MySQL ARM64，改用 sudo apt install default-mysql-server（实际安装 MariaDB），它对旧 ARM 兼容性更好，SQL 行为基本一致。
使用 Docker 部署时必须显式指定 --platform=linux/arm64
Docker Hub 的 mysql:latest 或 mysql:8 默认只含 x86_64 镜像，拉取后 docker run 会静默失败或报 no matching manifest for linux/arm64。
正确做法是：
- 用带
-arm64v8后缀的镜像：docker run --rm -e MYSQL_ROOT_PASSWORD=123 -p 3306:3306 mysql:8.0.33-arm64v8 - 或强制平台拉取：
docker pull --platform linux/arm64 mysql:8.0.33，再运行 - 构建自定义镜像时，在
Dockerfile开头加FROM --platform=linux/arm64 ubuntu:22.04
漏掉 --platform 是线上环境最常复现的“MySQL 启不来”原因，且日志里往往不报错，只卡在 Waiting for server startup。
源码交叉编译 MySQL 客户端库（libmysqlclient）的关键参数
如果你必须在 x86 主机上为 ARM 编译驱动（比如 Qt 的 MySQL 插件），libmysqlclient 是绕不开的一环。直接用 x86 工具链编译会产出错误架构的 so 文件，加载时报 cannot open shared object file: No such file or directory 或更隐蔽的 undefined symbol。
实操要点：
- 工具链必须用
aarch64-linux-gnu-gcc（不是arm-linux-gnueabihf-），否则生成的符号表与 ARM64 ABI 不兼容 - CMake 配置中必须加
-DWITHOUT_SERVER=ON，只编译客户端，跳过服务端依赖（如 libaio、ncurses） - 禁用可能引发崩溃的选项：
-DENABLED_LOCAL_INFILE=OFF -DDEFAULT_CHARSET=utf8mb4 - 安装路径需设为独立目录（如
/opt/arm-mysql），避免污染主机环境
编译完成后，用 file /opt/arm-mysql/lib/libmysqlclient.so 确认输出含 AArch64 字样，再用于后续 Qt 驱动编译。
ARM 上 MySQL 运行时参数调优不能照搬 x86 经验值
ARM 芯片（尤其信创平台如飞腾 D2000、鲲鹏 920）内存延迟高、总线带宽窄，innodb_buffer_pool_size 设成物理内存 75% 很可能触发 OOM；thread_handling=pool-of-threads 比默认的 one-thread-per-connection 更稳；buffer_pool_dump_at_shutdown 必须关掉，否则 shutdown 时 dump 大 buffer 可能卡死进程。
建议起始值参考：
-
innodb_buffer_pool_size：先设为内存的 40%，观察SHOW ENGINE INNODB STATUS中的 buffer pool hit rate -
max_connections：ARM 上并发 >200 易出现指令集级兼容性抖动，建议 ≤150 -
innodb_thread_concurrency：飞腾平台实测最佳值比同规格 Xeon 低约 30%，从 8 开始阶梯测试
所有参数调整后，务必用 strace -e trace=memory,socket,openat mysqld --defaults-file=/etc/mysql/my.cnf 观察底层系统调用是否异常——这是 x86 环境很少需要但 ARM 迁移中极有效的诊断手段。
