MySQL UDF 開發調試利器：DebugView 遠程即時追蹤

背景

MySQL UDF (User Defined Function) 本質是無需進入點的動態連結庫 (DLL/Shared Library)。傳統 IDE 調試需附加進程、配置符號表，對於緊急排查或無法安裝開發環境的生產機極不方便。

DebugView 介紹

• 官網：Sysinternals DebugView
• 支援 Win9x/NT 系列、核心模式調試、遠程接收輸出。
• 僅需呼叫 Windows API OutputDebugStringA(char*)，語言無關、專案類型無關。

實作範例 (C 語言)

#include <windows.h>
#include <stdio.h>

char* __stdcall my_name(UDF_INIT *initid, UDF_ARGS *args, char *is_null, char *error) {
    // 1. 標記進入點
    OutputDebugStringA("--UDF:my_name() called");

    char *me = "my name";

    // 2. 輸出變數值 (需組合成單一 char*)
    char debug_msg[256] = {0};
    sprintf(debug_msg, "return value: %s", me);
    OutputDebugStringA(debug_msg);

    return me;
}

使用流程

1. 目標機運行 MySQL，載入 UDF DLL。
2. 開發機啟動 DebugView → Capture → Capture Events → 勾選 Capture Global Win32 → 若遠程，輸入目標機 IP 連線。
3. 執行呼叫 UDF 的 SQL：SELECT my_name();
4. DebugView 即時顯示：
   --UDF:my_name() called
return value: my name

進階技巧

• 格式化輸出：用 sprintf/snprintf 組合多變數為單一字串。
• 條件編譯：以 #ifdef DEBUG 包裹調試碼，正式版編譯時排除，零效能損耗。
• Linux/Unix 平台：改用 syslog()、fprintf(stderr, ...) 或自訂共享記憶體環形緩衝區 + 守護進程收集。

優缺點總結