MariaDB mysql_install_db 初始化腳本深度解析：從參數解析到系統表創建全流程

前言

MySQL/MariaDB 實例初始化是部署的第一步，卻常因參數缺失、權限不足、路徑錯誤導致失敗。MariaDB 的 mysql_install_db 由 Shell 編寫，邏輯清晰可讀，是理解初始化原理的最佳切入點。本文從源碼級別剖析其核心流程：參數解析、路徑探測、配置讀取、權限校驗、目錄創建、系統表初始化，並總結「正確姿勢」避開常見坑點。

一、常見失敗場景複盤

二、核心變量與默認值

basedir=""          # 安裝根目錄
builddir=""         # 編譯目錄（源碼安裝用）
ldata="./data"      # 數據目錄，默認當前目錄下的 data
user=""             # 運行用戶
force=0             # 強制模式，忽略 DNS 解析失敗
cross_bootstrap=0   # 交叉編譯場景

三、關鍵函數鏈路

3.1 參數解析：parse_arguments()

雙階段解析機制：

1. 第一階段：僅解析 --basedir、--srcdir、--defaults-file 等影響 my_print_defaults 定位的參數
2. 第二階段：讀取配置文件 [mysqld]、[mysql_install_db] 組合並發參數，再解析命令行剩餘參數（存入 $args 透傳給 mysqld --bootstrap）

3.2 定位 my_print_defaults

# 優先級邏輯
if srcdir 指定:       print_defaults="$builddir/extra/my_print_defaults"
elif basedir 指定:    print_defaults=`find_in_basedir my_print_defaults bin extra`
else:                 print_defaults="./bin/my_print_defaults"  # 假設在 basedir 下執行

若不可執行（! -x）直接報錯退出。

3.3 讀取配置文件參數

parse_arguments `"$print_defaults" $defaults --mysqld mysql_install_db`

實際執行示例：

/usr/local/mysql/bin/my_print_defaults --defaults-file=/etc/my.cnf --mysqld mysql_install_db
# 輸出: --basedir=... --datadir=... --user=mysql ...

3.4 關鍵路徑探測與校驗

• mysqld：$basedir/libexec|sbin|bin/mysqld
• errmsg.sys：$basedir/share/english|share/mysql/english/errmsg.sys（錯誤碼映射，升級必更新）
• SQL 腳本：mysql_system_tables.sql、mysql_performance_tables.sql、fill_help_tables.sql、maria_add_gis_sp_bootstrap.sql

任一缺失或不可執行即退出。

3.5 主機名解析與 IP 模式

• 默認調用 resolveip 解析 hostname，失敗嘗試 localhost
• --skip-name-resolve / --force / --cross-bootstrap 可跳過或強制使用 IP

3.6 數據目錄創建與權限

mkdir -p "$ldata" "$ldata/mysql" "$ldata/test"
chmod 700 "$dir"
chown $user "$dir"  # 若指定 --user

3.7 系統表初始化：--bootstrap 模式

核心命令構建：

mysqld_bootstrap="${MYSQLD_BOOTSTRAP-$mysqld}"
"$mysqld_bootstrap" $defaults "$mysqld_opt" --bootstrap \
  --basedir="$basedir" --datadir="$ldata" \
  --log-warnings=0 --enforce-storage-engine="" \
  $args --max_allowed_packet=8M --net_buffer_length=16K

三階段導入：

1. 系統表：mysql_system_tables.sql + mysql_performance_tables.sql + mysql_system_tables_data.sql
2. 幫助表：fill_help_tables.sql
3. OpenGIS 存儲過程：maria_add_gis_sp_bootstrap.sql

關鍵點：--bootstrap 只執行初始化 SQL，**不啟動服務器**。

四、初始化「正確姿勢」清單

1. 顯式指定三大參數：--basedir、--datadir、--user
2. 預先創建目錄並授權：mkdir -p /data/mysql && chown -R mysql:mysql /data/mysql
3. 配置文件就位：/etc/my.cnf 包含 [mysqld] 基礎參數
4. 避開 /root 目錄：權限 500 導致非 root 用戶無法寫入
5. 檢查二進制文件權限：chmod +x $basedir/bin/mysqld

五、總結

MariaDB 的 mysql_install_db 體現了「約定優於配置」與「防禦性編程」：雙階段參數解析保證配置正確性，多路徑探測兼容源碼/二進制/當前目錄三種部署形態，--bootstrap 機制隔離初始化與運行時。掌握其流程，不僅能快速排查初始化失敗，更能深入理解 MySQL 系統表結構、權限體系與啟動機制的底層邏輯。