萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML5 教學

Java HTML 轉義工具類實作:防 XSS 的 escapeHTMLTags 完整解析

核心目的

將使用者輸入的特殊字元轉換為 HTML 實體,防止跨站腳本攻擊(XSS)。必須處理的四大字元:<、>、"、&。

標準實作(StringBuilder 高效能版)

public final class HtmlUtils {
  private HtmlUtils() {} // 工具類防實例化

  public static String escapeHtml(String input) {
    if (input == null || input.isEmpty()) return input;
    StringBuilder sb = new StringBuilder(input.length() + 16); // 預留空間減少擴容
    for (int i = 0; i < input.length(); i++) {
      char c = input.charAt(i);
      switch (c) {
        case '<':  sb.append("&lt;"); break;
        case '>':  sb.append("&gt;"); break;
        case '"': sb.append("&quot;"); break;
        case '&':  sb.append("&amp;"); break;
        default:    sb.append(c);
      }
    }
    return sb.toString();
  }
}

JSP/Thymeleaf 整合範例

<!-- JSP -->
<%= HtmlUtils.escapeHtml(userComment) %>

<!-- Thymeleaf 自動轉義 -->
<p th:text="${userComment}"></p>

<!-- 若需輸出原始 HTML(極度謹慎) -->
<div th:utext="${trustedContent}"></div>

現代替代方案

  • OWASP Java Encoder:Encode.forHtml(input),經過安全審計、效能優化。
  • Apache Commons Text:StringEscapeUtils.escapeHtml4(input)。
  • 框架內建:Spring MVC、Jakarta EE、Thymeleaf、FreeMarker 皆內建上下文感知輸出編碼。

測試用例

@Test void escapeHtmlTest() {
  assertEquals("&lt;script&gt;alert(1)&lt;/script&gt;", HtmlUtils.escapeHtml("<script>alert(1)</script>"));
  assertEquals("Tom &amp; Jerry", HtmlUtils.escapeHtml("Tom & Jerry"));
  assertEquals("", HtmlUtils.escapeHtml(""));
  assertNull(HtmlUtils.escapeHtml(null));
}
copyright © 萬盛學電腦網 all rights reserved