從資料庫讀出的欄位裡存著 HTML 程式碼,本想原樣渲染,畫面上卻看到一串 <span>...</span> 的純文字。這個問題通常不是資料錯了,而是輸出的方法不對。
// jQuery
$("#div").html("<span>我是HTML代碼</span>");
// 原生 JS
var dobj = document.getElementById("div");
dobj.innerHTML = "<span>我是HTML代碼</span>";
關鍵在於 html() 與 innerHTML 會把字串當 HTML 解析,而不是當純文字顯示。如果看到標籤被原樣印出來,通常表示內容是透過 text() 或 textContent 寫入的。
若上述方式仍無效,往往是資料在伺服器端就被編碼了。以 ASP.NET MVC 的 Razor 為例:
$("#div").html("@Html.Raw(Model.Content)");
Html.Raw() 的作用是跳過 Razor 預設的 HTML 編碼。Razor 基於安全考量,預設會把 < 轉成 <,所以即使資料正確,送到前端也已變成純文字。
其他框架的對應做法:
// Vue —— 使用 v-html
<div v-html="content"></div>
// React —— 使用 dangerouslySetInnerHTML
<div dangerouslySetInnerHTML={{ __html: content }} />
// Thymeleaf
<div th:utext="${content}"></div>
// PHP 原生
<div><?= $content ?></div> <!-- 不呼叫 htmlspecialchars 才會原樣輸出 -->
這不是巧合。Vue 要求你寫 v-html、React 把方法命名為 dangerouslySetInnerHTML,都是在提醒:跳過轉義等於把 XSS 的判斷責任交給你。
只要內容有一部分來自使用者輸入,攻擊者就能存入 <img src=x onerror=alert(1)> 這類 payload,而所有看到該頁的使用者都會執行它。這正是儲存型 XSS 最常見的成因。
若內容確實是可信的(例如由編輯在後台撰寫),仍建議在輸出前做白名單消毒,而非完全放行:
// 使用 DOMPurify 過濾危險標籤與屬性
var clean = DOMPurify.sanitize(userHtml);
document.getElementById('div').innerHTML = clean;
伺服器端也該做同樣的事——前端消毒只能保護當前使用者,繞過前端直接呼叫 API 攻擊依然可行。真正的防線必須在資料寫入或讀出的那一層。
另一個判斷依據是:如果這段 HTML 只是為了排版(例如把換行轉成 <br>),那麼根本不需要放行完整 HTML。在伺服器端把特定字元替換成對應標籤,比開放任意標籤安全得多。