【Javaエラー】エンティティ" ... "への参照は';'デリミタで終了する必要があります。

▶

この記事の要点

エンティティ "..." への参照は ";" デリミタで終了する必要があります はXML / HTML / JSP で & 文字をエスケープしていない
原因: & はエンティティ参照の開始文字なので、文字として使うには & にエスケープ必須
対処: URL のクエリ区切り、SQL の AND 等で & をそのまま書いている箇所を & に
JSP / XML の場合はで自動エスケープが安全

エラーの状況

XML エラー
エンティティ "page" への参照は ";" デリミタで終了する必要があります。

# または英語版
The reference to entity "page" must end with the ';' delimiter.

XML パーサがエンティティ参照（&...;）を期待した位置で、& の後に文字が続いて ; で終わらない、というエラー。HTML / JSP / XML / 設定ファイル等で発生します。


  
  

結果: SELECT * FROM users WHERE active=true & deleted=false

XML パーサは & を見つけるとエンティティ参照の始まりと解釈します:

これらの形式以外は不正と判定されてエラーになります。


  


SELECT * FROM users WHERE active=true & deleted=false







    検索


<%@ page contentType="text/html;charset=UTF-8" %>


${userInput}
  





${fn:escapeXml(userInput)}

HTML5 では「& + 既知のエンティティ名 + ;」以外の & はそのまま許容されるのでブラウザ表示は壊れません。しかしXML として処理する場面（XHTML / SVG / XML 出力）では厳格にエラーになります。


プレースホルダ



プレースホルダ


{{ $userInput }}



{!! $trustedHtml !!}

// React は自動エスケープ
{userInput}  // &, <, > 自動エスケープ
  // 危険

// Vue
{{ userInput }}  // 自動エスケープ
  // 危険


http://example.com/?a=1&b=2



    jdbc/Pool&1




    https://example.com?a=1&b=2

JSON は XML ではないので、& のエスケープは不要:

// JSON
{"url": "/search?q=hello&page=2"}  // OK

// ただし JSON を HTML に埋め込む際は HTML 側でエスケープが必要