MySQL 移植至嵌入式 Linux 平台的關鍵步驟與裁剪策略

移植目標與挑戰

嵌入式 Linux 通常面臨：CPU 資源受限（ARM/MIPS）、記憶體 64MB-512MB、儲存空間緊張、無 MMU 或 uClibc/musl libc。MySQL 須大幅裁剪以適應邊緣網關、工控機、車載終端等場景。

交叉編譯工具鏈準備

• 取得目標平台 SDK：arm-linux-gnueabihf-gcc、aarch64-linux-gnu-gcc 等。
• 依賴庫交叉編譯：zlib、openssl、libaio、ncurses、protobuf、rapidjson（8.0+）。
• 設定環境變數：

export CC=arm-linux-gnueabihf-gcc
export CXX=arm-linux-gnueabihf-g++
export STRIP=arm-linux-gnueabihf-strip
export CFLAGS="-Os -pipe -fomit-frame-pointer"
export CXXFLAGS="-Os -pipe -fomit-frame-pointer"

CMake 裁剪配置關鍵選項

在源碼目錄建立 build_embedded，執行 cmake .. -DCMAKE_TOOLCHAIN_FILE=arm.cmake -D... ，核心裁剪參數：

存儲引擎選擇策略

• InnoDB：核心事務引擎，保留。可透過 innodb_file_per_table=OFF、innodb_log_file_size 小值、innodb_buffer_pool_size 極小（8-16MB）壓縮記憶體佔用。
• MyISAM/MEMORY/CSV/ARCHIVE/BLACKHOLE/FEDERATED/PARTITION：按需裁剪，嵌入式多為單應用、單引擎，建議僅保留 InnoDB。

運行時極致精簡配置

[mysqld]
# 極簡配置範例（64MB RAM 設備）
loose_innodb_buffer_pool_size = 8M
loose_innodb_log_file_size = 4M
loose_innodb_log_buffer_size = 256K
loose_innodb_flush_log_at_trx_commit = 2
loose_innodb_file_per_table = 0
loose_max_connections = 20
loose_thread_stack = 192K
loose_sort_buffer_size = 64K
loose_read_buffer_size = 16K
loose_read_rnd_buffer_size = 16K
loose_join_buffer_size = 16K
loose_tmp_table_size = 64K
loose_max_heap_table_size = 64K
skip-networking          # 僅本地 Unix Socket
skip-name-resolve
skip-host-cache
disable_log_bin
loose_innodb_flush_method = O_DIRECT
performance_schema = OFF
information_schema_stats_expiry = 0

部署與驗證

1. make install DESTDIR=/tmp/mysql_embedded 收集安裝檔案。
2. arm-linux-gnueabihf-strip 二進制檔（mysqld、libmysqlclient.so）。
3. 打包必要檔案：bin/mysqld、lib/libmysqlclient.*、share/mysql/english/errmsg.sys、support-files/mysql.server。
4. 目標板初始化：mysqld --initialize-insecure --datadir=/data/mysql --basedir=/usr/local/mysql。
5. 啟動測試：mysqld --defaults-file=/etc/my.cnf &，mysql -u root -e "SHOW ENGINES; SHOW VARIABLES LIKE 'version';"。

替代輕量級方案

• SQLite：零配置、單檔案、<500KB，適合極簡本地存儲。
• MariaDB：支援更多嵌入式優化、更小體積構建選項。
• MySQL Embedded (libmysqld)：應用直接鏈接庫，無獨立進程，Context 切換開銷為零。

通過激進裁剪編譯選項、精簡存儲引擎、極限運行參數，MySQL 可在 32MB+ RAM 的嵌入式 Linux 上穩定運行，為邊緣計算提供關係型資料能力。