故障現象

Mac OS X (10.8+) 上啟動 MySQL Workbench 6.x 彈窗：

"MySQLWorkbench quit unexpectedly."

點擊 Ignore/Report/Reopen 任一按鈕均無法啟動，重裝也無效。

根因分析

用戶級配置目錄 ~/Library/Application Support/MySQL/Workbench/ 中的配置文件（如 wb_options.xml、窗口狀態、最近連接歷史）損壞或版本不兼容，導致啟動初始化崩潰。

解決方案：刪除/備份配置目錄重置

方法一：完整重置（最快，會丟失保存的連接）

# 終端執行
rm -rf ~/Library/Application\ Support/MySQL/Workbench/

# 重新啟動 MySQL Workbench，自動創建乾淨配置目錄

方法二：保留連接信息的安全重置（推薦）

# 1. 備份連接配置
cp ~/Library/Application\ Support/MySQL/Workbench/connections.xml ~/connections.xml.backup

# 2. 刪除配置目錄
rm -rf ~/Library/Application\ Support/MySQL/Workbench/

# 3. 啟動 Workbench（自動創建新目錄）
# 打開應用，關閉歡迎界面

# 4. 恢復連接配置
cp ~/connections.xml.backup ~/Library/Application\ Support/MySQL/Workbench/connections.xml

# 5. 重啟 Workbench
# 連接信息恢復，崩潰問題解決

方法三：僅清除窗口狀態（保留連接與偏好設置）

# 僅刪除窗口布局狀態文件
rm -f ~/Library/Application\ Support/MySQL/Workbench/wb_layout.xml
rm -f ~/Library/Application\ Support/MySQL/Workbench/wb_options.xml
# 保留 connections.xml、snippets/、scripts/ 等

日志分析（進階排查）

若上述方法無效，查看崩潰日志：

# 系統崩潰報告
/Applications/Utilities/Console.app
# 或
~/Library/Logs/DiagnosticReports/MySQLWorkbench_*.crash

# Workbench 內部日志
~/Library/Application\ Support/MySQL/Workbench/log/

常見崩潰堆棧關鍵字：

• GtkWidget / GDK → GTK 主題/顯示驅動問題
• python / PyObject → Python 插件/腳本衝突
• SSL / crypto → OpenSSL 版本衝突

Mac 環境特有優化建議

1. 使用 Homebrew 管理安裝

brew install --cask mysqlworkbench
# 自動處理依賴、版本兼容、路徑規範

2. 解決 Retina 顯示模糊/崩潰

# 編輯啟動腳本
vim /Applications/MySQLWorkbench.app/Contents/MacOS/MySQLWorkbench
# 在 exec 行前添加：
export GDK_SCALE=2
export GDK_DPI_SCALE=0.5

3. 避免 Python 版本衝突

# Workbench 內嵌 Python 2.7，系統若默認 Python 3 可能衝突
# 建議：不依賴系統 Python，使用內嵌版本
# 或創建別名：
alias mysqlworkbench='/Applications/MySQLWorkbench.app/Contents/MacOS/MySQLWorkbench'

版本兼容性對照表

macOS 版本	推薦 Workbench 版本	備註
10.15 Catalina +	8.0.23+	需支持 notarization、ARM64
10.14 Mojave	8.0.13 - 8.0.22	最後支持 32 位插件
10.13 High Sierra	6.3.10 - 8.0.12
10.12 Sierra	6.3.8 - 6.3.10

替代工具推薦

• Sequel Ace（原 Sequel Pro 繼任者，免費開源，原生 Mac 體驗）
• TablePlus（多數據庫支持，現代 UI，免費版功能足夠）
• DBeaver（跨平台、Java 基礎、功能最全）
• DataGrip（JetBrains 出品，專業級，付費）

官方 Bug 參考

• Bug #70066 - Workbench crashes on startup on Mac OS X
• 官方 Mac 安裝文檔