はじめに (対象読者・この記事でわかること)

この記事は、Struts 1.x系のフレームワークを使用して開発されたWebアプリケーションの運用・保守に携わるJavaエンジニア、またはStrutsアプリケーションで突然の404エラーに直面し、その原因究明に困っている方を対象としています。

この記事を読むことで、Strutsアプリケーションにおける404エラーの一般的な発生メカニズムを理解し、具体的なトラブルシューティングの手順とチェックポイントを学ぶことができます。これにより、複雑な設定やデプロイ環境の中で隠れたエラーの原因を効率的に特定し、迅速に解決できるようになるでしょう。レガシーなシステムだからこそ発生しやすい特有の問題にも焦点を当てて解説します。

前提知識

この記事を読み進める上で、以下の知識があるとスムーズです。 * Javaの基本的なプログラミング知識 * Webアプリケーション開発の基本的な知識 (HTTPメソッド、URLパス、Servlet/JSPの概念など) * Strutsフレームワーク (特にStruts 1.x系) の基本的な知識 (struts-config.xml, Actionクラス, ActionFormなど) * Tomcatなどのサーブレットコンテナの基本的な操作とログの見方

なぜStrutsアプリケーションで404エラーは発生するのか？基本的な仕組みと落とし穴

Webアプリケーションにおける404エラー（Not Found）は、リクエストされたリソースがサーバー上に見つからないことを示すHTTPステータスコードです。Strutsアプリケーションにおいてもこのエラーは頻繁に発生しますが、その原因は多岐にわたります。

Strutsアプリケーションがリクエストを受け取って処理する基本的なフローは以下のようになります。

  1. Webサーバー/サーブレットコンテナ: ユーザーからのリクエストを受け付けます。
  2. web.xmlの設定: web.xmlに定義されたStrutsのActionServletまたはActionFilterが、特定のリクエストパターン（例: *.do）をインターセプトします。
  3. struts-config.xmlの解析: Strutsはstruts-config.xmlを読み込み、リクエストされたパスに対応する<action>要素を探します。
  4. Actionクラスの実行: マッピングされたActionクラスが実行され、ビジネスロジックが処理されます。
  5. JSP/HTMLへの転送: 処理結果に基づいて、<forward>で指定されたJSPやHTMLページに制御が移ります。

このフローのどの段階で問題が発生しても、最終的にブラウザには404エラーが返される可能性があります。特にStrutsは設定ファイルに依存する部分が多いため、設定ミスやデプロイ環境の不整合が404エラーの主な原因となることが多いです。例えば、struts-config.xmlに記載されたアクションパスと実際のURLが一致しない、Actionクラスの指定が間違っている、または必要なファイルがサーバーにデプロイされていないといったケースが挙げられます。

レガシーなStrutsアプリケーションでは、開発環境と本番環境の差異、複雑なビルドプロセス、あるいは長期間のメンテナンスによる設定の陳腐化など、現代のフレームワークではあまり見られない特有の落とし穴が存在します。これらの背景を理解することで、より効率的なトラブルシューティングが可能になります。

Strutsアプリケーション404エラーの徹底診断と具体的な解決策

Strutsアプリケーションで404エラーが発生した場合、以下のステップで体系的に診断を進めることが重要です。

ステップ1: エラー発生状況の確認とログ解析

まず、何が404エラーになっているのかを正確に把握することから始めます。

  1. ブラウザの開発者ツールで確認:

    • F12キーなどで開発者ツールを開き、"Network"タブを確認します。
    • ステータスコードが404になっているリクエストのURLを特定します。画像、CSS、JavaScriptファイルなのか、それともStrutsのアクションパス（例: /login.do）なのかを識別します。
    • レスポンスボディにエラーメッセージが含まれている場合もありますので、確認します。

  2. サーバーログの確認:

    • Tomcatなどのサーブレットコンテナのログ（例: catalina.out, localhost.<日付>.log）を確認します。
    • Strutsは通常、アクションが見つからない場合や設定ファイルに問題がある場合に、詳細なエラーメッセージをログに出力します。
      • 例: No action mapped for path /<requested_path>
      • 例: Could not find config file struts-config.xml
      • 例: Error initializing action servlet
    • これらのメッセージは原因を特定する上で非常に重要なヒントとなります。

  3. アプリケーションログの確認:

    • アプリケーション独自のログファイルがある場合は、それも確認します。特に、リクエストの前処理やStrutsの初期化フェーズで発生する可能性のあるエラーを捕捉できる場合があります。

ステップ2: web.xmlとstruts-config.xmlの確認

Strutsアプリケーションの根幹を成す設定ファイルを確認します。

  1. web.xmlの確認:

    • Struts ActionServletまたはActionFilterの設定:
      • <servlet>または<filter>定義が正しく記述されているか。
      • <servlet-mapping>または<filter-mapping>の<url-pattern>（例: *.do）が、404になっているURLと一致しているか。
      • <init-param>でstruts-config.xmlのパスが正しく指定されているか（例: /WEB-INF/struts-config.xml）。 xml <!-- web.xmlの例 --> <servlet> <servlet-name>action</servlet-name> <servlet-class>org.apache.struts.action.ActionServlet</servlet-class> <init-param> <param-name>config</param-name> <param-value>/WEB-INF/struts-config.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>action</servlet-name> <url-pattern>*.do</url-pattern> </servlet-mapping>
    • 他のサーブレットやフィルタのマッピングと競合していないか確認します。

  2. struts-config.xmlの確認:

    • <action>パスの確認:
      • 404になっているURLのパス（例: /login.doなら/login）と、<action path="/login">が完全に一致しているか確認します。
      • 大文字・小文字、末尾のスラッシュの有無に注意してください（特にLinux系環境では大文字・小文字を区別します）。
    • Actionクラスの指定:
      • <action type="com.example.action.LoginAction">のtype属性で指定されたActionクラスの完全修飾名が正しいか。
      • 指定されたクラスが実際に存在し、コンパイルエラーがないか。
    • Forwardパスの確認:
      • <forward name="success" path="/pages/login.jsp"/>のように指定されたJSPやHTMLファイルのパスが正しいか。
      • これらのファイルが実際にサーバーにデプロイされているか。
    • DTD/XSDの確認:
      • struts-config.xmlの先頭に記述されているDTDまたはXSDのバージョンが、使用しているStrutsのバージョンと合致しているか確認します。バージョン不一致は解析エラーの原因となります。

ステップ3: デプロイ状況とファイルパスの確認

ファイルがサーバーに正しく配置されているかを物理的に確認します。

  1. WARファイルの展開状況:

    • Webサーバー（Tomcatなど）のwebappsディレクトリにデプロイされたWARファイルが正しく展開されているかを確認します。
    • 例: /path/to/tomcat/webapps/your_app/

  2. クラスファイルの存在:

    • ActionクラスやActionFormクラスの.classファイルが、WEB-INF/classesディレクトリ以下の正しいパッケージパスに存在するか確認します。
    • 例: com.example.action.LoginAction.class → WEB-INF/classes/com/example/action/LoginAction.class

  3. ライブラリの存在:

    • WEB-INF/libディレクトリに必要なStrutsライブラリ（struts.jar, struts-core.jarなど）やその他の依存ライブラリが全て存在するか確認します。バージョン不整合も問題となる場合があります。

  4. JSP/HTMLファイルの存在:

    • Strutsのフォワード先として指定されているJSPやHTMLファイルが、指定された相対パスに正しく配置されているかを確認します。

ステップ4: サーバー環境の確認

アプリケーションが動作しているサーバー環境自体に問題がないかを確認します。

  1. アプリケーションの起動状況:

    • アプリケーションがサーブレットコンテナ上で正常に起動しているか。起動時にエラーがないかログで確認します。
    • アプリケーションのコンテキストパス（例: http://localhost:8080/myapp/)が正しいか。

  2. キャッシュの問題:

    • 変更が反映されない場合、サーバー側のキャッシュが原因であることがあります。サーバーをクリーンアップしてから再起動します。
    • 場合によっては、webappsディレクトリからアプリケーションを完全に削除し、再度WARファイルをデプロイし直すことも有効です。

ハマった点やエラー解決

Strutsの404エラーでよく遭遇するハマりどころと、その解決策をまとめます。

  • struts-config.xmlの変更が反映されない: サーブレットコンテナはstruts-config.xmlを起動時に一度読み込むため、変更後は必ずサーバーを再起動する必要があります。ホットデプロイ環境でも完全に反映されない場合があります。
  • 大文字・小文字の区別: Windows環境では意識しにくいですが、LinuxなどのOSではファイル名やURLのパスの大文字・小文字を厳密に区別します。struts-config.xmlのpath属性やJSPファイル名が実際のファイルと一致しているか確認しましょう。
  • web.xmlのサーブレットマッピングの競合: 複数のサーブレットやフィルタが同じURLパターンを処理しようとしている場合、予期しない動作や404エラーが発生することがあります。
  • Actionクラスのパッケージミス: struts-config.xmlで指定したtype属性のパッケージ名が間違っている、またはクラスファイルが正しいパッケージ階層にデプロイされていない。
  • ライブラリのバージョン不整合: WEB-INF/libに複数のStrutsバージョンや互換性のないライブラリが混在していると、クラスロードエラーや予期せぬ動作を引き起こし、最終的に404エラーにつながる場合があります。
  • struts-config.xmlの構文エラー: XMLの閉じタグ忘れや属性名のミスなど、基本的な構文エラーでもStrutsが設定ファイルを解析できず、エラーになることがあります。サーバーログにXML解析エラーが出力されます。

解決策

上記のチェックリストを一つ一つ確認し、原因を特定することが解決への近道です。特に、サーバーログに注目し、Strutsが出力する具体的なエラーメッセージを見逃さないようにしましょう。

コード例として、Strutsの基本設定が正しく機能しているかを確認するためのシンプルなActionとstruts-config.xmlの抜粋を示します。

Xml

<!-- WEB-INF/struts-config.xml の例 -->
<struts-config>
    <action-mappings>
        <action path="/greet" type="com.example.action.GreetingAction">
            <forward name="success" path="/WEB-INF/jsp/greeting.jsp"/>
        </action>
    </action-mappings>
</struts-config>

Java

// src/com/example/action/GreetingAction.java の例
package com.example.action;

import org.apache.struts.action.Action;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionForward;
import org.apache.struts.action.ActionMapping;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class GreetingAction extends Action {
    @Override
    public ActionForward execute(ActionMapping mapping, ActionForm form,
                                 HttpServletRequest request, HttpServletResponse response) throws Exception {
        request.setAttribute("message", "Strutsアプリケーションは正常に動作しています！");
        return mapping.findForward("success");
    }
}

Jsp

<!-- WEB-INF/jsp/greeting.jsp の例 -->
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Greeting</title>
</head>
<body>
    <h1><%= request.getAttribute("message") %></h1>
</body>
</html>

この設定で/greet.doにアクセスし、正しくJSPが表示されれば、Strutsの基本的なルーティングとActionの実行は問題ないことになります。

まとめ

本記事では、Strutsアプリケーションで突然発生する404エラーの原因と、その具体的な解決策について詳しく解説しました。

  • ログと開発者ツールの活用: エラーが発生しているリソースの特定と、サーバーログからの詳細なエラーメッセージの読み取りが、問題解決の第一歩です。
  • 設定ファイルの徹底確認: web.xmlとstruts-config.xmlにおけるStrutsの初期化、サーブレットマッピング、アクションパス、フォワードパスの記述が正しいかを念入りに確認することが重要です。
  • デプロイ環境の確認: クラスファイル、ライブラリ、JSPファイルなどがサーバーの正しいパスに配置されているか、キャッシュの問題がないかを物理的に確認することも不可欠です。

この記事を通して、Strutsアプリケーションの404エラーに遭遇した際に、パニックにならず体系的に問題を診断し、効率的に解決できるようになっていただけたなら幸いです。 今後は、Strutsアプリケーションのさらなるデバッグ手法や、より現代的なフレームワークへの移行パスについても記事にする予定です。

参考資料