この記事の要点
Struts の NullPointerException: Module 'null' not found 直接の条件: JSPタグが必要なModuleConfigを取得できない。直接アクセスだけで原因を断定しない 対処1: ActionServletの起動ログとconfigの全ファイルを確認。設定の読込み・登録失敗を先に調べる 対処2: web.xmlの設定と対象モジュールを照合。welcome-fileの変更だけを万能な対処にしない

 

Struts 1のModule 'null' not foundは、JSPタグが必要なモジュール設定を見つけられないエラーです。まずActionServletの初期化と設定ファイルを確認します。以下はStruts 1.3.10の実装に基づく保守向けの説明です。ApacheはStruts 1の保守を終了しており、新規導入の推奨ではありません。

エラー内容

java.lang.NullPointerException: Module 'null' not found.     org.apache.struts.taglib.TagUtils.getModuleConfig(TagUtils.java:755)     org.apache.struts.taglib.TagUtils.computeURLWithCharEncoding(TagUtils.java:364)     org.apache.struts.taglib.TagUtils.computeURLWithCharEncoding(TagUtils.java:285)     org.apache.struts.taglib.logic.RedirectTag.generateRedirectURL(RedirectTag.java:289)     org.apache.struts.taglib.logic.RedirectTag.doEndTag(RedirectTag.java:268)     org.apache.jsp.index_jsp._jspx_meth_logic_005fredirect_005f0(index_jsp.java:159)     org.apache.jsp.index_jsp._jspService(index_jsp.java:121)     org.apache.jasper.runtime.HttpJspBase.service(HttpJspBase.java:70)     javax.servlet.http.HttpServlet.service(HttpServlet.java:729)     org.apache.jasper.servlet.JspServletWrapper.service(JspServletWrapper.java:438)     org.apache.jasper.servlet.JspServlet.serviceJspFile(JspServlet.java:396)     org.apache.jasper.servlet.JspServlet.service(JspServlet.java:340)     javax.servlet.http.HttpServlet.service(HttpServlet.java:729)     org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52)

 

発生条件と原因

以下は元記事の設定ファイル指定例です。複数ファイルのうち一つが見つからず、ActionServletのモジュール初期化に失敗する経路を確認します。

<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, test.xml</param-value>     </init-param>     <load-on-startup>2</load-on-startup>   </servlet>

configファイルを読み込む際に「test.xml」を解決できなければ、設定の読込みは成功しません。Struts 1.3.10の検証では、存在する設定と存在しないファイルを同じconfigに指定すると、初期化中にUnavailableExceptionが発生し、既定モジュールは登録されませんでした。その後のJSPタグの設定取得失敗とは別の段階です。掲載スタックトレースだけから、当時の起動失敗がこの一例だったと断定することはできません。

 

対処法

存在するファイルパスを記載する。configに複数指定がある場合は一つずつ確認します。例えばWebアプリ内のWEB-INF/test.xmlを読む意図なら、/WEB-INF/struts-config.xml, /WEB-INF/test.xmlのように実際の配置に合うパスを指定します。ファイルが不要なら、他の設定と依存関係を確認してから不要な指定を外します。名前だけ変えて内容や配置を確認しない対処は避けてください。

 

最短の確認手順

1. 実際に配備されているStrutsの版とWebアプリを確認します。IDEのソースと配備済みWARが一致しているとは限りません。
2. JSPの例外より前の起動ログを読みます。ActionServletの初期化失敗、設定ファイル未検出、XML解析エラー、関連する例外を確認し、最初の失敗を直します。
3. web.xmlのActionServletとinit-paramを照合します。configの全ファイルが配備物に含まれ、指定した場所から読めるか確認します。起動ログを公開する場合は秘密情報を伏せてください。
4. 名前付きモジュールを使う場合は、config/adminなどの設定と対象のモジュール名を照合します。既定モジュールと別モジュールの設定を混同しません。
5. 検証環境で正式な再配備・再起動手順に従い、初期化成功と元の操作の両方を確認します。JSPの一画面が出るだけで、Actionやフォーム処理も正常と判断しないでください。

JSPへ直接アクセスしただけで発生するのか

必ず発生するわけではありません。Struts 1.3.10のTagUtilsはModuleUtilsへ設定取得を委ねます。モジュール名が未指定なら、要求に選択済みのModuleConfigがあるか調べ、なければアプリ側に登録された既定モジュールを探します。取得結果がnullの場合に、掲載例と同じ例外が発生します。メッセージのnullは、この呼出しでモジュール名が未指定だったことを表し、「nullという名前の設定ファイル」を作る指示ではありません。

単体検証では、ActionServletを通った要求の設定がなくても、既定モジュールが登録されていれば取得に成功しました。反対に、要求と既定モジュールの両方に設定がなければ同じ例外になります。明示的に指定したモジュール名が存在しない場合は、その名前を含む別のメッセージになります。

業務画面をAction経由で表示する設計では、その正しい経路を使うことも必要です。ただし、ActionServletの初期化自体が失敗している場合、welcome-fileやJSPのリンク先だけを変えても設定読込失敗は直りません。例外を隠すために内部属性へModuleConfigを手動登録する対処も勧めません。

ログと設定をどう切り分けるか

確認できた状況	優先して確認すること
起動時に設定ファイルが見つからない	configの全指定、WAR内の実ファイル、パスと大文字小文字。TagUtilsの例外より先に初期化を直す
設定ファイルはあるがXML解析が失敗する	起動ログが示す行と要素、対象版の設定書式。存在確認だけで終えない
起動成功後にもModule 'null' not foundが出る	同じWebアプリの既定モジュール登録と、要求に選択されたモジュール。別の配備物や古い版を見ていないかも確認
例外に具体的なモジュール名が出る	その名前のモジュール設定・登録・利用する要求経路。既定モジュールへ勝手に置き換えない

検証範囲と一次資料

Struts 1.3.10、Servlet API 2.5、JSP API 2.0、Java 21の隔離単体テストで、未登録時の例外と755行目、既定設定へのフォールバック、要求側の優先、名前付きモジュール、設定読込成功、複数指定の一つが欠ける初期化失敗を確認しました。ServletContextや要求は合成データです。Tomcat上のJSP表示全体、旧IDE操作、すべてのStruts版、当時の障害原因を再現したものではありません。

一次資料（2026年10月確認）：Struts 1.3.10 taglibソース（TagUtils、sources JAR）、Struts 1.3.10 coreソース（ModuleUtils、ActionServlet、sources JAR）。使用している版が違う場合はその版の実装・行番号を照合してください。