この記事の要点
パス "..." に対するアクションのインスタンスを取得できません はStruts 1 で Action クラスがロードできないエラー 原因 ①: Action クラスのパスが struts-config.xml と一致しない 原因 ②: Action クラスのコンパイル失敗・classpath 漏れ 原因 ③: パッケージ移動でクラス名のフルパス変更を反映していない 対処: struts-config.xml の <action type="..." > のクラス名を確認

 

エラーの状況

javax.servlet.ServletException: パス "/login" に対するアクションのインスタンスを取得できません。

# 英語版
Cannot retrieve definition for form bean null on action /login

# または
Cannot create instance of action class for path /login

Struts 1 の ActionServlet がリクエストを処理する際、struts-config.xml で指定された Action クラスを生成できなかったエラー。

原因と対処

原因 1: Action クラスが見つからない

<!-- struts-config.xml -->
<action-mappings>
    <action path="/login"
            type="com.example.LoginAction">  <!-- ← このクラスがない -->
        <forward name="success" path="/home.jsp"/>
    </action>
</action-mappings>

確認:

• com/example/LoginAction.class が WEB-INF/classes/ 配下にあるか
• Maven 等でビルドし忘れていないか
• Eclipse でプロジェクト → クリーン

原因 2: クラス名のタイポ / パッケージ違い

<!-- 修正前 -->
<action path="/login" type="com.example.LogginAction">  <!-- ← typo: Loggin -->

<!-- 修正後 -->
<action path="/login" type="com.example.LoginAction">

原因 3: Action クラスのコンストラクタや継承

// 必須: 引数なしコンストラクタ + Action 継承
public class LoginAction extends Action {
    // 暗黙のデフォルトコンストラクタで OK

    @Override
    public ActionForward execute(
            ActionMapping mapping,
            ActionForm form,
            HttpServletRequest request,
            HttpServletResponse response) throws Exception {
        // ...
    }
}

// ダメな例
public class LoginAction {  // ← Action を継承していない
    public LoginAction(String name) { }  // ← 引数ありコンストラクタしかない
}

原因 4: パッケージリネーム後の反映漏れ

IDE でパッケージをリネームしたとき、Java コードはリファクタリングされても XML はそのままになることがあります:

<!-- リネーム前 com.example.controller.LoginAction -->
<!-- リネーム後 com.example.action.LoginAction に変更したのに -->

<action path="/login" type="com.example.controller.LoginAction">  <!-- ← 古いまま -->

<!-- 修正 -->
<action path="/login" type="com.example.action.LoginAction">

原因 5: WEB-INF/lib に依存 jar 不足

Action クラスがサードパーティクラスを使っている場合、その jar がないとクラスロードに失敗:

# WEB-INF/lib にすべての依存 jar があるか確認
$ ls WEB-INF/lib/
struts.jar
commons-beanutils.jar
commons-logging.jar
...

調査の手順

1. Tomcat のログを確認: $CATALINA_HOME/logs/localhost.YYYY-MM-DD.log に詳細スタックトレース
2. クラスファイルの存在確認: WEB-INF/classes/<package>/<ClassName>.class
3. struts-config.xml の type 属性とクラス名一致
4. Eclipse でプロジェクトクリーン: ビルド成果物を再生成
5. Tomcat の再起動: クラスローダのキャッシュをクリア

標準的な Action クラスのテンプレート

package com.example;

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

public class LoginAction extends Action {

    @Override
    public ActionForward execute(
            ActionMapping mapping,
            ActionForm form,
            HttpServletRequest request,
            HttpServletResponse response) throws Exception {

        LoginForm loginForm = (LoginForm) form;

        if (isValidUser(loginForm.getUsername(), loginForm.getPassword())) {
            return mapping.findForward("success");
        } else {
            return mapping.findForward("failure");
        }
    }

    private boolean isValidUser(String username, String password) {
        // 認証ロジック
        return true;
    }
}

Struts 1 vs モダンフレームワーク

Struts 1 は2013 年でサポート終了のレガシーフレームワーク。新規開発では Spring MVC / Spring Boot を推奨。Struts 1 の保守をする場合のみこの記事の内容が必要です。

関連記事

• struts-config.xmlの説明
• アノテーション一覧 (Spring)