この記事の要点

XMLスキーマ検証で、現在の親要素の内容モデルに合わない子要素を検出。順序だけが原因とは限らない メッセージ: cvc-complex-type.2.4.a: Invalid content was found starting with element "X". One of {...} is expected. 原因候補: 子要素の場所・名前空間・重複・対象XSDの版。Maven POM 4.0.0のModelはallで、トップレベルのbuildとdependenciesの前後だけではエラーにならない 対処: メッセージの要素と親要素を特定し、実際に使われたXSDの定義を確認して必要な箇所だけ修正 検証OFFは修正ではない。IDEの参照先と独立したXSD検証を比較し、設定削除や全体の検証停止を初手にしない IDEの検査、Mavenのモデル読込、サーバー起動は別の経路。どれかが成功しても他の正しさを保証しない

このエラーは「その位置で許されない要素がある」という診断です。まず構文・接頭辞、名前空間とXSD、その親の内容モデルの順に調べます。順序が自由なスキーマへ、順序固定の対処を当てはめないことが重要です。

このエラーの典型

次の旧メッセージ例は位置の読み方を示す記録です。標準POM 4.0.0でトップレベルのbuildとdependenciesを入れ替えただけの再現結果ではありません。実際のエラーの行番号・親要素・参照XSDを確認してください。

Description                              Resource    Path  Location  Type
cvc-complex-type.2.4.a: Invalid content
was found starting with element
'dependencies'. One of '{...build,
...profiles, ...repositories}' is expected.
                                         pom.xml     /demo  line 25   XML Problem

意味: 「dependencies 要素が出てきたが、ここでは build / profiles / repositories のいずれかが期待されている」。現在の検証状態でその要素が許可されないというシグナルです。順序違反のほか、入れ子の間違い・重複・異なる名前空間などでも発生し得ます。期待候補だけで原因を断定しません。

原因: XSD の sequence は順序固定

XML Schema (XSD) には <xsd:sequence> という構造があり、子要素を定義した順に書かなければならない制約があります。ただし、すべてのXMLの親要素がsequenceで定義されているわけではありません。Maven POM 4.0.0のModelは下の抜粋にもあるallです。sequence、all、choiceと出現回数は対象の親ごとに確認します。

<!-- pom.xml の XSD 定義（抜粋） -->
<xsd:complexType name="Model">
    <xsd:all>
        <xsd:element name="modelVersion" .../>
        <xsd:element name="parent" .../>
        <xsd:element name="groupId" .../>
        <xsd:element name="artifactId" .../>
        <xsd:element name="version" .../>
        <xsd:element name="packaging" .../>
        ...
        <xsd:element name="dependencies" .../>
        <xsd:element name="build" .../>
        ...
    </xsd:all>
</xsd:complexType>

例 1: pom.xml で順序が違う

この見出しと旧例のNG/OK判定を訂正します。 POM 4.0.0のトップレベルではbuildの後にdependenciesを書いても順序だけでNGにはなりません。次の元の例は比較記録として残しますが、コメントのNG判定は誤りです。名前空間と内容を省略しているため、そのまま実行・検証する完成POMでもありません。

<!-- ❌ NG: build より後に dependencies がきている -->
<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>1.0</version>

    <build>
        <plugins>...</plugins>
    </build>

    <dependencies>  <!-- ← cvc-complex-type.2.4.a -->
        <dependency>...</dependency>
    </dependencies>
</project>

<!-- ✅ OK: dependencies → build の順 -->
<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>1.0</version>

    <dependencies>
        <dependency>...</dependency>
    </dependencies>

    <build>
        <plugins>...</plugins>
    </build>
</project>

pom.xml の正しい要素順序

下表は読みやすくまとめる配置例で、XSDが要求する唯一の順序ではありません。 表の順に並べ替えることをエラー解決の条件にしないでください。Model内の要素の重複や、dependenciesの中へbuildを置くような親子の間違いは別に確認します。

順	要素
1	<modelVersion>
2	<parent>
3	<groupId>, <artifactId>, <version>, <packaging>
4	<name>, <description>, <url>
5	<properties>
6	<dependencyManagement>
7	<dependencies>
8	<build>
9	<profiles>, <repositories> など

例 2: web.xml で順序が違う

Servlet 4.0についての旧NG判定も訂正します。 Apache Tomcat配布のweb-app_4_0.xsdは、web-app直下の子要素を任意順で記述できると説明しています。filterの後のcontext-paramだけで順序違反とはいえません。次の例は省略を含む旧記録です。filter内部の必須項目・使用中のDTD/XSD・版は別に照合し、古いDTDの順序規則と混同しないでください。

<!-- ❌ NG: filter の後に context-param -->
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" version="4.0">
    <display-name>app</display-name>
    <filter>...</filter>

    <context-param>  <!-- ← cvc-complex-type.2.4.a -->
        <param-name>x</param-name>
        <param-value>y</param-value>
    </context-param>
</web-app>

<!-- ✅ OK: 正しい順序 -->
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" version="4.0">
    <display-name>app</display-name>
    <context-param>...</context-param>
    <filter>...</filter>
    <filter-mapping>...</filter-mapping>
    <listener>...</listener>
    <servlet>...</servlet>
    <servlet-mapping>...</servlet-mapping>
    <session-config>...</session-config>
    <welcome-file-list>...</welcome-file-list>
    <error-page>...</error-page>
</web-app>

例 3: Spring XML で xmlns 不足

次のNG例ではcontextだけでなくxsiも未宣言です。未宣言の接頭辞はXSDの内容モデル検証より前の名前空間解析エラーであり、同じcvc-complex-type.2.4.aと断定しません。接頭辞を宣言しても、URIが別だったり対象XSDが読み込まれなかったりすれば、さらに別の検証エラーが残る場合があります。

<!-- ❌ NG: context: の xmlns 未宣言 -->
<beans xmlns="http://www.springframework.org/schema/beans"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
           http://www.springframework.org/schema/beans/spring-beans.xsd">

    <context:component-scan base-package="com.example"/>
</beans>

<!-- ✅ OK: xmlns:context を宣言 -->
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="
           http://www.springframework.org/schema/beans
           http://www.springframework.org/schema/beans/spring-beans.xsd
           http://www.springframework.org/schema/context
           http://www.springframework.org/schema/context/spring-context.xsd">

    <context:component-scan base-package="com.example"/>
</beans>

対処手順

1. エラーメッセージの One of {...} is expected 部分を見る — そこに期待される候補要素が列挙されている
2. エラーの要素の直接の親、xmlnsのURI、schemaLocationやIDE catalogで実際に参照するXSDと版を確認する。URIの見た目とprefix名だけで判断しない
3. その親のsequence/all/choice、minOccurs/maxOccurs、許可される子を確認する。誤った入れ子・綴り・重複を先に照合し、sequenceの順序違反を確認できた場合だけ並べ替える
4. 同じXMLを対象XSDで独立に検証し、IDEの結果と比較する。Mavenのモデル読込成功をXSD検証成功と扱わない
5. IDEだけで違いが残る場合は参照XSD・catalog・プラグイン版を照合する。.project / .settingsの削除・作り直しを通常の対処にしない。変更が必要な場合も既存設定と影響を保存・確認する

最終手段: XML 検証を OFF

検証をOFFにしてマーカーが消えてもXMLを修正したことにはなりません。 IDEだけの誤検知を独立した検証で確認した場合に限り、担当者が影響を確認して一時的な除外を検討します。全体の検証停止を一般的な解決策として勧めません。

1. Project を右クリック → Properties
2. Validation → Enable project specific settings
3. XML Validatorの対象・catalog・Build/Manualの現在値を確認する。両方を外して症状だけ隠さない
4. 設定差を記録し、必要な変更だけ適用して再検証する。除外した場合も独立した検証と復旧条件を残す

次の旧除外例も、原因を直すものではありません。未解決のファイルを除外して成功扱いにしないでください。

<!-- pom.xml で対象ファイルを Validation 除外 -->
<!-- Eclipse Preferences → Validation → XML Validator → Settings →
     Exclude Group で path: **/web.xml 等を追加 -->

FAQ

Q: ビルド・実行は通るのに Eclipse だけエラー
A: IDEとビルドが同じ検証をしているとは限りません。参照先XSD・catalog・版と実際の検証範囲を比較します。古いXSDが原因と決めつけず、ログに読込失敗がないかも確認してください。

Q: pom.xml の順序を自動で正しく並べる
A: 整形とXSD検証は別です。POMのトップレベルを表の順に自動整列する必要はありません。使用中のIDE・プラグインで整形の変更範囲を確認し、親子関係や依存の意味を変えないよう差分を見ます。

Q: cvc-complex-type.2.4.b との違い
A: 番号だけで対処を決めず全文を読みます。2.4.aは許可されない子要素、2.4.bは内容が未完了といった診断で現れます。2.4.cを「想定外＋必須欠け」とまとめるのは誤りで、strictなwildcardに一致しても要素宣言を見つけられない診断など、実際の検証器のメッセージを確認してください。

独立検証で確認したこと

検体	結果と意味
POM 4.0.0でbuild→dependencies／逆順	正しい名前空間と最小モデルを用いた両方が公式XSDで有効。順序だけの修正は不要。
同じPOMでbuildを二重に記述	XSD検証失敗。順序自由は重複自由ではない。
同じPOMに未定義の子要素／名前空間なし	それぞれXSD検証失敗。綴り・親・名前空間を照合する。
a,bを定義した最小sequence／all	sequenceはa→bのみ有効、allは両順有効。実際の親の定義によって対処が異なる。
未宣言のcontext接頭辞	XML解析段階で失敗。XSDの並べ替えで直す問題ではない。

これはlxmlによるXSD/名前空間の独立検証です。Eclipseの特定版のマーカー、Spring起動、Tomcatへのweb.xml配備全体を再現したものではありません。変更後はIDE検査と実際のビルド・起動を別々に確認してください。

一次資料

• Apache Maven POM 4.0.0公式XSD
• Apache Tomcat配布のServlet 4.0 XSD
• W3C XML Schema Part 1