萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery $.post 無響應排查:特殊字元導致請求失效的解決方案

使用 $.post 發送資料時,若 payload 包含 <、> 等特殊字元,可能導致請求靜默失敗、伺服器解析錯誤或 WAF 攔截。本文分析根因、提供轉義工具函數,並說明現代 fetch / axios 的正確處理方式。

問題重現

var jsonStr = '{"value":"abcd

根因分析

  1. jQuery 內部序列化:$.param() 會對資料做 application/x-www-form-urlencoded 編碼
  2. 特殊字元未正確編碼:< > & = 等在 URL 編碼中有特殊含義
  3. 伺服器端解析失敗:PHP $_POST、Java request.getParameter() 依賴標準編碼
  4. WAF/防火牆攔截:<script> 等模式觸發 XSS 防護

手動轉義工具函數 (舊專案救急)

function escapeHtmlChars(str) {
  return String(str)
    .replace(/&/g, '&')
    .replace(//g, '>')
    .replace(/"/g, '"')
    .replace(/'/g, ''');
}

// 使用
var jsonStr = '{"value":"abcd

⚠️ 注意:這只是將字元實體化,伺服器端需對應解碼 (PHP html_entity_decode),否則資料庫存入 &lt; 而非 <。

正確做法:讓 jQuery 正確編碼

不要手動拼 JSON 字串,直接傳遞物件,讓 $.param() 正確編碼:

// ✅ 正確:傳遞物件,jQuery 自動序列化並編碼
$.post('/api/save', { 
  value: 'abcdspecial' }
}, callback);

// ✅ 若必須傳 JSON 字串:先建物件,再 JSON.stringify
const payload = { value: 'abcdspecial' } };
$.post('/api/save', { jsonstr: JSON.stringify(payload) }, callback);
// jQuery 會正確編碼 { } " : < > 等字元為 %7B %7D %22 %3A %3C %3E

現代最佳實踐:fetch + JSON

async function postJson(url, data) {
  const res = await fetch(url, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(data) // 正確序列化,無編碼問題
  });
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  return res.json();
}

// 使用
postJson('/api/save', { value: 'abcdspecial' } })
  .then(data => console.log('成功:', data))
  .catch(err => console.error('失敗:', err));

axios 自動處理

import axios from 'axios';
axios.post('/api/save', { value: 'abcd

編碼對照表

字元URL 編碼HTML 實體JSON 轉義
<%3C&lt;\u003C 或 直接保留 (JSON 字串中合法)
>%3E&gt;\u003E
&%26&amp;\u0026
"%22&quot;\"
'%27&#39;字串界定符需轉義

伺服器端對應處理

平台Content-Type解析方式
PHPapplication/x-www-form-urlencoded$_POST 自動解碼
PHPapplication/jsonjson_decode(file_get_contents('php://input'), true)
Node/Expressapplication/jsonexpress.json() middleware → req.body
Java/Springapplication/json@RequestBody DTO
Python/Flaskapplication/jsonrequest.get_json()

總結

  1. 不要手工拼接 JSON 字串再傳遞
  2. 傳遞純 JS 物件,讓庫正確序列化與編碼
  3. 若必須傳 JSON 字串欄位,用 JSON.stringify(obj) 產生
  4. 現代專案遷移至 fetch/axios,Content-Type: application/json 避免編碼地獄
  5. 伺服器端確保對應 Content-Type 正確解析

編碼問題 90% 來自「手工拼字串」。用對工具、傳對格式,問題自然消失。

copyright © 萬盛學電腦網 all rights reserved