この記事の要点
Struts の createActionForm で NullPointerException 優先確認: form-beanのtypeとクラス配置。Struts 1.3.10の289行目はクラス未解決で再現 対処: <action> の name= と <form-bean> の name= が一致しているか確認 別パターン: 引数なしコンストラクタがない場合は、この検証ではInstantiationException。NPEと混同しない

 

Struts 1の保守向け記事です。 ApacheはStruts 1の保守を終了しています。新規導入の推奨ではありません。以下はStruts 1.3.10の実装と掲載スタックトレースを照合した診断です。別バージョンの同じ行番号が同じ処理とは限りません。

エラー内容

java.lang.NullPointerException     org.apache.struts.config.FormBeanConfig.createActionForm(FormBeanConfig.java:289)     org.apache.struts.config.FormBeanConfig.createActionForm(FormBeanConfig.java:357)     org.apache.struts.chain.commands.CreateActionForm.execute(CreateActionForm.java:92)     org.apache.struts.chain.commands.ActionCommandBase.execute(ActionCommandBase.java:51)     org.apache.commons.chain.impl.ChainBase.execute(ChainBase.java:191)     org.apache.commons.chain.generic.LookupCommand.execute(LookupCommand.java:305)     org.apache.commons.chain.impl.ChainBase.execute(ChainBase.java:191)     org.apache.struts.chain.ComposableRequestProcessor.process(ComposableRequestProcessor.java:283)     org.apache.struts.action.ActionServlet.process(ActionServlet.java:1913)     org.apache.struts.action.ActionServlet.doGet(ActionServlet.java:449)     javax.servlet.http.HttpServlet.service(HttpServlet.java:622)     javax.servlet.http.HttpServlet.service(HttpServlet.java:729)     org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52)

 

発生条件と原因

ActionFormを生成しようとした際に発生するエラー。

このスタックだけでform-bean未定義と断定はできません。Struts 1.3.10の289行目はformBeanClass().newInstance()です。formBeanClass()はtypeのクラスをロードできない場合にnullを返すため、その次の呼び出しでNullPointerExceptionになります。type未設定・クラス名の誤記・配置や依存クラスの欠落を優先して調べます。

 

対処法

「struts-config.xml」の<form-bean>タグに使用するActionFormを定義する。

 

名前とtypeを対応させる

以下はstruts-config.xmlのフォームとActionの対応を示す例です。既存設定へ必要な要素を組み込んでください。example.SampleActionと/sample.jspは説明用で、実際に用意したActionクラスとJSPへ合わせます。このXMLだけでアプリ全体が完成するわけではありません。

<struts-config>
  <form-beans>
    <form-bean name="sampleForm" type="example.SampleForm" />
  </form-beans>
  <action-mappings>
    <action path="/sample" type="example.SampleAction"
            name="sampleForm" scope="request" validate="false">
      <forward name="success" path="/sample.jsp" />
    </action>
  </action-mappings>
</struts-config>

typeで指定するexample.SampleFormは、example/SampleForm.classに対応します。以下はsrc/main/java/example/SampleForm.javaの独立したフォーム例です。旧プロジェクトでは実際のソースフォルダへ合わせてください。publicなクラスで、引数なしコンストラクタが使える構成にします。

package example;

import org.apache.struts.action.ActionForm;

public class SampleForm extends ActionForm {
    private String message;

    public String getMessage() { return message; }
    public void setMessage(String message) { this.message = message; }
}

配備したクラスを確認する

• Javaのpackage、クラス名、XMLのtypeが大文字小文字まで一致するか確認します。
• ビルド結果がWEB-INF/classes/example/SampleForm.class、またはWEB-INF/lib内のJARに含まれているか確認します。IDEでコンパイルできてもWARに含まれなければロードできません。
• 同じモジュールでactionのnameとform-beanのnameが一致するか確認します。別のstruts-config.xmlを読んでいないかも見ます。
• クラスが継承・参照するライブラリが配備されているか、周辺ログにClassNotFoundException / NoClassDefFoundErrorがないか確認します。
• 重複した旧JARや配備済みクラスを確認し、管理された再ビルド・再配備後に同じURLで再確認します。本番ファイルを推測で削除しません。

標準のCreateActionForm処理では、対応するform-beanが見つからない場合は警告を出し、フォームをnullにして戻ります。名前の不一致も直すべきですが、それだけを289行目のNPEの直接原因と決めつけないでください。

今回確認した再現条件

Struts 1.3.10の条件	検証結果
存在するSampleFormをtypeへ指定	ActionFormを生成。XMLのnameの対応も確認
存在しない完全修飾クラス名	FormBeanConfig.java:289のNPEを再現
type未設定	NPEを再現
引数ありコンストラクタだけを定義	InstantiationException。掲載NPEとは別

検証はStruts 1.3.10実体のフォーム生成とXML対応の4ケースです。Tomcat上の起動・Action/JSPの実行・全配備構成は未検証です。既存環境の手順はStruts 1の旧導入手順も参照できますが、保守終了のため新規採用は勧めません。

公式資料: Struts 1.3.10 FormBeanConfig、CreateActionForm、Apacheの保守終了案内（2026年10月確認）。