XMLの整形式(well-formed)とは|よくあるエラーの直し方

XMLを読み込もうとしたときに出る「整形式ではありません」といったエラー。本記事では、整形式(well-formed)の意味と、よくある原因・直し方を解説します。

整形式(well-formed)とは

整形式とは、XMLの構文規則を満たしていることです。意味が正しいかどうか(スキーマに沿っているか)とは別の話で、あくまで「XMLとして機械的に読み込める形になっているか」を指します。整形式でなければ、そもそもXMLとして解析(パース)することすらできません。

原因1:タグが閉じられていない

開始タグに対応する終了タグがない、あるいは閉じる順番が入れ子構造になっていないケースです。

<book><title>サンプル</book></title>  ← エラー(順番が逆)
<book><title>サンプル</title></book>  ← 正しい

HTMLでは多少のタグの閉じ忘れをブラウザが補って表示してくれることがありますが、XMLではそのような補完は行われず、エラーになります。

原因2:属性値がクォートされていない

属性の値は、ダブルクォートまたはシングルクォートで必ず囲む必要があります。

<item id=1>  ← エラー
<item id="1">  ← 正しい

原因3:ルート要素が1つに定まっていない

XML文書全体は、必ず1つのルート要素で囲まれている必要があります。同じ階層に複数の要素が並んでいて、それらを囲む外側の要素がない場合、整形式ではないと判定されます。

<item>A</item>
<item>B</item>
← ルート要素がなくエラー

<items>
  <item>A</item>
  <item>B</item>
</items>
← 正しい

原因4:特殊文字がエスケープされていない

「<」「&」のような、XMLの構文上意味を持つ文字が、テキストの中にそのまま含まれていると、エラーになります。これらの文字をテキストとして使いたい場合は、&lt;や&amp;のような実体参照に置き換える必要があります。

SVGファイルも同じ仕組み

SVG(画像のベクター形式)は、XMLの一種として定義されています。そのため、SVGファイルが崩れて表示される場合も、ここで挙げたXMLの整形式のルールに沿って確認すると、原因を見つけやすくなります。

整形式と妥当性の違い

XMLの検証には、2つの異なる段階があります。混同しやすいので、区別して考えると理解が進みます。

整形式(well-formed): タグの対応や属性のクォートなど、XMLの文法を満たしているかどうかです。ここでは、データの内容は見ていません。

妥当性(valid): XSDやDTDという定義ファイルに従っているかどうかです。「この要素には数値が入るべき」「この要素は必須」といった、データの意味や構造の条件を確認します。

整形式でないXMLは、そもそも解析できないため、妥当性の検証に進めません。まずは整形式かどうかを確認し、次に必要に応じて妥当性を確認するのが順序です。本ツールは整形式かどうかを確認し、整形式でない場合は問題の箇所を表示します。

また、名前空間(xmlns)の宣言が抜けていると、タグの名前は正しくても、別の要素として扱われてしまうことがあります。SVGや帳票など、名前空間を使う形式では特に確認が必要です。

よくある質問

整形式はXMLの文法、妥当性はXSDやDTDによるデータの構造と内容の条件です。整形式でなければ妥当性の確認はできません。

宣言と実際のファイルの文字コードが違うと、文字化けや解析エラーが起きます。宣言を実際の保存形式に合わせてください。

XMLとしての構文エラーや、名前空間の宣言漏れが原因のことがあります。整形式かどうかを確認してから、SVGとしての記述を見直してください。

まとめ

XMLの整形式エラーの多くは、タグの閉じ忘れ、属性値のクォート漏れ、ルート要素の欠落、特殊文字のエスケープ漏れの4つに集約されます。

XML整形ツールでは、整形式かどうかのチェックとあわせて、エラー箇所を確認できます。

戻る