ThinkPHP 內建 jsonRPC 缺陷深度剖析與修正方案

問題發現歷程

專案需開發 iOS/Android/Web 多端共用 API，選用 ThinkPHP 3.2 內建 jsonRPC。Web 與 Android 調用正常，iOS 使用 objc-JSONRpc、Demiurgic-JSON-RPC 兩個庫均失敗。排查半天鎖定為伺服端問題。

核心缺陷定位

在 ThinkPHP/Library/Think/Controller/JsonRpc.class.php 中發現關鍵行：

$result = @call_user_func_array(array($object, $request['method']), $request['params'])

call_user_func_array 要求第二參數必須為陣列，但 ThinkPHP 未對 $request['params'] 做型別檢查與正規化。iOS 端發送的參數結構導致此處為非陣列值，直接觸發錯誤卻被 @ 抑制，回傳空白響應，極難除錯。

修正方案

在呼叫前強制正規化為數值索引陣列：

if (is_array($request['params'])) {
    $request['params'] = array_values($request['params']);
} else {
    $request['params'] = array($request['params']);
}
// 之後再呼叫 call_user_func_array

驗證結果

• iOS 端兩個庫均正常調用。
• Web/Android 端相容性無影響。
• 單元測試覆蓋：params 為 null、純量、關聯陣列、數值陣列四種情況。

擴充建議

1. 移除 @ 抑制錯誤，改用 try-catch 記錄日誌並回傳標準錯誤碼（如 -32600 Invalid Request）。
2. 加入 JSON-RPC 2.0 完整規範支援（jsonrpc、id、error 物件）。
3. 考慮改用成熟庫 ezimuel/JsonRPC 或 ReactPHP/JsonRpc，避免維護內建缺陷代碼。

此缺陷提醒我們：框架內建元件未必生產就緒，關鍵路徑務必自行審計與測試。