萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP + AJAX 常見錯誤總結:dataType 陷阱、JSON 格式、回傳值處理

經典錯誤場景

前端 AJAX 設定 dataType: 'json',後端 PHP 多次 echo 字串,導致進入 error 回調而非 success。

錯誤代碼重現

前端 (jQuery AJAX)

$.ajax({
    url: '1.php',
    data: {"age": 12, "name": "zh"},
    type: 'post',
    dataType: 'json',  // ⚠️ 關鍵:宣告期望 JSON 格式
    success: function(response) { console.log(response); },
    error: function(response) { console.log("錯誤", response); }
});

後端 PHP (錯誤寫法)

$postAge = $_POST['age'];
$postName = $_POST['name'];
echo $postAge;      // 輸出 "12"
echo $postName;     // 輸出 "zh"
// 實際回傳:12zh  ❌ 非合法 JSON

為什麼會進入 error?

  1. dataType: 'json' 告訴瀏覽器:「我期望收到合法 JSON,請幫我解析」
  2. PHP 回傳 12zh(兩個字串直接拼接)
  3. 瀏覽器嘗試 JSON.parse("12zh") → 拋出語法錯誤
  4. jQuery 判定傳輸失敗,觸發 error 回調

正確解決方案

方案一:PHP 端輸出合法 JSON(推薦)

$postAge = $_POST['age'];
$postName = $_POST['name'];

// 組裝關聯陣列
$result = array(
    'age' => $postAge,
    'name' => $postName
);

// 一次性輸出 JSON
echo json_encode($result);
// 輸出:{"age":"12","name":"zh"} ✅

方案二:前端移除 dataType(不推薦,失去驗證)

// 註解或刪除 dataType 行
// dataType: 'json',

瀏覽器會智能判斷,但失去格式驗證保護。

深度解析:json_encode vs json_decode

函數用途範例
json_encode($var)PHP 變數 → JSON 字串json_encode(['a'=>1]) → '{"a":1}'
json_decode($json, true)JSON 字串 → PHP 陣列json_decode('{"a":1}', true) → ['a'=>1]
json_decode($json)JSON 字串 → PHP 物件json_decode('{"a":1}') → stdClass Object

錯誤觀念: json_encode($postAge) 單獨編碼每個變數再 echo,會產生多個 JSON 片段拼接,同樣非合法 JSON。

其他常見坑

1. PHP 只能用 echo/die,不能用 return

// ❌ 錯誤
function api() { return $data; }

// ✅ 正確
function api() { echo json_encode($data); }
// 或
function api() { die(json_encode($data)); }

2. $.ajax 參數語法

  • 參數間用逗號分隔
  • 物件內鍵值對用冒號,逗號分隔
  • 字串需用引號包裹

3. 多次 echo 會合併輸出

即使修正為 JSON,若不小心 echo json_encode($a); echo json_encode($b); 會輸出 {...}{...},前端收到單一字串導致解析失敗。永遠只輸出一次完整 JSON。

4. HTTP 狀態碼

PHP 預設回傳 200 OK。若需語意化狀態碼:

http_response_code(400);  // 錯誤請求
http_response_code(401);  // 未授權
http_response_code(500);  // 伺服器錯誤

除錯檢查清單

  1. F12 Network 面板查看 Response 原始內容
  2. 用 JSONLint 驗證格式
  3. 確認 Content-Type: application/json
  4. 檢查 PHP 錯誤日誌(錯誤訊息會混入輸出破壞 JSON)
  5. 關閉 PHP 警告輸出:error_reporting(0) 或設定 display_errors=Off
copyright © 萬盛學電腦網 all rights reserved