MySQL 跨平台文件操作封裝機制解析：標準 C 庫與 Win32 API 雙重實現

雙重封裝背景

MySQL 源碼中文件操作存在兩套並行實現：

• POSIX/標準 C 庫：open/close/read/write/seek 等，Unix/Linux 原生
• Win32 API：CreateFile/CloseHandle/ReadFile/WriteFile/SetFilePointer 等，Windows 原生

為什麼不統一用標準 C 庫？

雙方均可創建文本/二進制文件，功能對等：

Win32 獨特優勢：統一句柄模型與異步 I/O

1. 統一句柄模型

CreateFile 不僅打開文件，還能打開通信設備、命名管道、郵件槽、磁盤、控制台等內核對象。參數豐富：

HANDLE CreateFile(
  LPCTSTR lpFileName,           // 文件/設備路徑
  DWORD dwDesiredAccess,        // 訪問模式 (GENERIC_READ/WRITE)
  DWORD dwShareMode,            // 共享模式 (FILE_SHARE_READ/WRITE/DELETE)
  LPSECURITY_ATTRIBUTES lpSA,   // 安全屬性，通常 NULL
  DWORD dwCreationDisposition,  // 創建方式 (CREATE_NEW/ALWAYS/OPEN_EXISTING...)
  DWORD dwFlagsAndAttributes,   // 標志屬性 (FILE_FLAG_OVERLAPPED 等)
  HANDLE hTemplateFile          // 模板文件句柄，通常 NULL
);

返回 INVALID_HANDLE_VALUE 表示失敗。

2. 異步 I/O 原生支持（關鍵性能優勢）

• 同步模式：默認，調用 ReadFile/WriteFile 直到完成才返回，線程阻塞。
• 異步模式：CreateFile 指定 FILE_FLAG_OVERLAPPED，後續 ReadFile/WriteFile 立即返回，I/O 在後台完成，線程可執行其他任務，大幅提升併發吞吐。

完成通知機制：事件對象、完成例程、I/O 完成端口 (IOCP)—— Windows 高性能服務器架構基石。

MySQL 封裝策略啟示

1. 平台抽象層 (PAL)：上層調用統一接口（如 my_read/my_write/my_seek），編譯時鏈接平台特定實現。
2. 性能優先原則：Windows 下利用 IOCP 實現高併發網絡/磁盤 I/O，Linux 下用 epoll + AIO/libaio。
3. 避免運行時分支：編譯期綁定消除虛函數/函數指針開銷。

對開發者的借鑒

• 跨平台高性能庫必須封裝平台原生異步 I/O 能力，而非退守同步標準庫。
• Windows 下務必使用 IOCP處理高併發網絡/文件 I/O，Linux 下用 io_uring (5.1+) 或 epoll + libaio。
• 文件操作抽象層設計參考 MySQL mysys/ 目錄實現（my_open/my_read/my_write/my_seek/my_close）。