從後端拿到一段 JSON 字串,準備顯示在頁面上,結果畫面上出現的是原始碼或一堆 " 之類的字符——這個問題幾乎每個人都遇過。原因通常只有一個:取值與寫入的方法選錯了。
在 JSP 中直接輸出含 HTML 的變數時,字元會被轉義成實體,瀏覽器於是把它當文字顯示。解法是關閉 XML 轉義:
<c:out value='${jxOrgJsonStr}' escapeXml="false"/>
escapeXml="false" 告訴 JSTL 不要進行跳脫。但要非常小心:這等於關掉了 XSS 的防線。只有在內容來源可信(例如你自己維護的設定檔)時才能這樣做;若字串中含有使用者輸入,必須先做白名單消毒再輸出。
另一個常見寫法是改用 innerText 接收值:
document.getElementById('xxxx').innerText = xxxx;
innerText 的語意是「純文字」,因此即使字串裡有 <b>、<style>,也會被原封不動地顯示出來。曾有人在做 FCKeditor 資料展示時遇到「HTML 與 CSS 全部攤在畫面上」,就是這個原因。
document.getElementById('xxxx').innerHTML = xxxx;
innerHTML 會把字串解析為 HTML,標籤才會真正生效。上面的引號問題也是同一個道理:寫入端選對方法,轉義與否的問題就自然消失。
var el = document.getElementById('demo');
el.innerText = "<b>粗體</b>"; // 畫面顯示:<b>粗體</b>
el.innerHTML = "<b>粗體</b>"; // 畫面顯示:粗體(真的變粗)
// 讀取時同理
el.innerText; // 只拿到可見文字
el.innerHTML; // 拿到含標籤的原始 HTML
選擇原則:要顯示純文字(尤其是使用者輸入)用 textContent;要渲染 HTML 才用 innerHTML。順帶一提,讀取純文字時 textContent 比 innerText 更合適——後者會觸發 reflow 以取得「渲染後」的文字,效能較差,且不包含隱藏元素。
先消毒再寫入。可以用 DOMParser 解析後移除危險元素與屬性,或直接採用成熟套件:
// 概念示意:只允許特定標籤
const allowed = ['B', 'I', 'EM', 'STRONG', 'P', 'BR'];
const doc = new DOMParser().parseFromString(html, 'text/html');
doc.querySelectorAll('*').forEach(node => {
if (!allowed.includes(node.tagName)) node.remove();
});
el.innerHTML = doc.body.innerHTML;
實務上更推薦 DOMPurify 這類專門的消毒庫,涵蓋的攻擊手法比手工白名單完整得多。
遇到「引號變成 "」或「標籤被顯示出來」,先確認是不是在寫入端用了 innerText 或在輸出端開了 escapeXml="false"。對症下藥比事後的字串取代可靠,而關閉轉義前,務必先想清楚資料來源是否可信。