C 語言返回指針的函數陷阱與四種修復方案深度解析

問題現場：看似正確實則危險的代碼

char* GetStaffNameById(int iId) {
    stStaffInfo stTmpInfo[] = {  // 局部數組，棧上分配
        {"Socrates", 1},
        {"dyx1024", 2},
        {"Kevin", 3},
        {"Jim", 4}
    };
    for (int i = 0; i < 4; i++)
        if (stTmpInfo[i].iId == iId)
            return stTmpInfo[i].pName;  // 返回局部數組成員地址！
    return "No match Name";
}

運行輸出正確（Staff Name is : dyx1024），但屬於未定義行為：函數返回後棧幀銷毀，返回指針指向已釋放內存，後續任意函數調用均可能覆蓋該區域。

四種修復方案對比

方案一：靜態存儲期（全局/文件級 static）

static stStaffInfo stTmpInfo[] = {  // 文件作用域，程序生命周期
    {"Socrates", 1}, {"dyx1024", 2}, {"Kevin", 3}, {"Jim", 4}
};

char* GetStaffNameById(int iId) {
    for (int i = 0; i < 4; i++)
        if (stTmpInfo[i].iId == iId) return stTmpInfo[i].pName;
    return "No match Name";
}

• ✅ 簡單、零開銷
• ❌ 非線程安全（多線程並發修改數據時有競態）
• ❌ 污染全局命名空間

方案二：函數內部 static

char* GetStaffNameById(int iId) {
    static stStaffInfo stTmpInfo[] = {  // 函數級 static，初始化一次
        {"Socrates", 1}, {"dyx1024", 2}, {"Kevin", 3}, {"Jim", 4}
    };
    // ... 同方案一
}

• ✅ 封裝性更好，不污染文件作用域
• ❌ 同樣非線程安全（C11 起可用 _Thread_local 緩解）

方案三：出參模式（推薦）

void GetStaffNameById(int iId, int nameLen, char *outName) {
    if (!outName) return;
    stStaffInfo stTmpInfo[] = { ... };  // 局部數組安全
    for (int i = 0; i < 4; i++)
        if (stTmpInfo[i].iId == iId) {
            strncpy(outName, stTmpInfo[i].pName, nameLen);
            return;
        }
    strncpy(outName, "No match Name", nameLen);
}

// 調用
char name[21];
GetStaffNameById(2, 20, name);

• ✅ 完全安全：調用者控制內存生命周期，無懸空指針風險
• ✅ 線程安全：各線程傳入獨立緩衝區
• ✅ 明確所有權語義
• ⚠ 需調用者預分配緩衝區

方案四：被調用者分配、調用者釋放

char* GetStaffNameById(int iId) {
    stStaffInfo stTmpInfo[] = { ... };
    char *ret = malloc(20);
    if (!ret) exit(1);
    for (int i = 0; i < 4; i++)
        if (stTmpInfo[i].iId == iId) { strncpy(ret, stTmpInfo[i].pName, 20); return ret; }
    strncpy(ret, "No match Name", 20);
    return ret;
}

// 調用
char *name = GetStaffNameById(2);
printf("%s\n", name);
free(name);  // 必須釋放！

• ✅ 靈活，調用者無需預知大小上限
• ❌ 易忘記 free 導致洩漏
• ❌ 分配失敗處理粗暴（exit(1)）

決策矩陣

核心原則