34.1.2 サーブレット・コンテナで発生したExceptionまたはErrorについて

Interstage Application Server メッセージ集

34.1.2 サーブレット・コンテナで発生したExceptionまたはErrorについて

　Servletサービスでよく発生するJavaのExceptionやError、アプリケーションが異常終了する要因について説明します。
　サーブレットまたはJSPが異常終了した場合、サーブレット・コンテナの標準出力・標準エラー出力のログ、サーブレットのログ、サーブレット・コンテナのログまたはブラウザにJavaのスタックトレースが出力されます。
　考えられる原因と対処を以下に示します。
　なお、ここで述べる原因とは、当該Exceptionが発生する引き金となる根本原因を指します。
　また、複数のExceptionが同時に発生している場合は、「Root cause:」のExceptionの対処を行ってください。

　ここでのメッセージは、メッセージの内容を直接参照してください。

BindException

［原因］
　サーブレット・コンテナ環境定義ファイルに設定したサーブレット・コンテナのクラス定義のIPアドレス、ポート番号への接続に失敗しています。
　ポートが使用中であるか、IPアドレスの割り当てに失敗している可能性があります。

［ユーザの対処］
　サーブレット・コンテナ環境定義ファイルに設定したサーブレット・コンテナのクラス定義のIPアドレス、ポート番号の設定を見直してください。
　定義したポートが使用中でないことを確認してください。
　現在使用中のポートについては、netstatコマンドで確認できます。netstatコマンドについてはOSのマニュアルおよびヘルプを参照ください。
　コンテナの標準出力、標準エラー出力のログに以下のメッセージが出力された場合には、“起動ログおよびコンテナの標準出力、標準エラー出力のログメッセージ”を参照してください。
　　　FATAL: java.net.BindException: Address in use: bind
　　　java.net.BindException: Address in use: bind
　　　または
　　　FATAL: java.net.BindException: Cannot assign requested address: JVM_Bind
　　　java.net.BindException: Cannot assign requested address: JVM_Bind

ClassCastException

［原因］
　サーブレットまたはJSPのリロードにより、WWWブラウザとのセション情報の不整合が発生しました。

［ユーザの対処］
　WWWブラウザのセション情報をクリア(サーブレット・コンテナ環境定義ファイルのContextManagerまたはContextタグのclientSession属性を省略または"default"を指定している場合はWWWブラウザを終了する)し、セション管理を最初からやり直してください。または、アプリケーションでClassCastExceptionをcatchし、セションの無効化処理をアプリケーションに追加してください。この場合、WWWブラウザのセション情報のクリアは必要ありません。

CORBA.COMM_FAILURE

［原因］
　CORBAサービスとの連携で異常が発生しました。

［ユーザの対処］
　"CORBAサービスから通知される例外情報/マイナーコード"を参照してください。

IncompatibleClassChangeError

［原因］
　アプリケーション・コンパイル時のJDKの環境と、アプリケーション実行時のJDKの環境が異なります。

［ユーザの対処］
　アプリケーションをコンパイルしたJDKのバージョンとサーブレット・コンテナが動作するJDKのバージョンを同じにしてください。
　JDKのバージョン指定は、"J2EEユーザーズガイド"の"JServlet環境定義ファイル"の"default.binまたは[containername].bin"を参照してください。
　または、サーブレット・コンテナのJDKの環境に合わせてアプリケーションを再コンパイルしてください。

java.io.IOException

［原因］
　コンテナの標準出力、標準エラー出力のログに以下のメッセージが出力された場合には、"起動ログおよびコンテナの標準出力、標準エラー出力のログメッセージ"を参照してください。
　　　HANDLER THREAD PROBLEM: java.io.IOException: Stream broken
　　　java.io.IOException: Stream broken

　その他の場合、サーブレット・コンテナがレスポンスを送信中にサーブレット・ゲートウェイ－サーブレット・コンテナ間のソケットが切断されたことにより発生することがあります。
　ゲートウェイがコンテナの応答処理の完了を待たずにソケットを切断するタイミングは以下の通りです。

WWWブラウザなどのクライアントアプリケーションが処理を中断（ソケットを切断）したことを検出しました。
- ユーザオペレーションによる中断。
- クライアントのキャッシュ制御による自動的な中断。
サーブレット・ゲートウェイのタイムアウトが発生しました。

［ユーザの対処］

この場合、クライアントアプリケーションからの中断であり、サーバ上の異常を示すものではありません。この場合IOExceptionが出力される要因は以下のものがあります。
- クライアントアプリケーションの終了
- リクエストの完了を待たずに中止ボタンを押下
- リロードの連打
- リンク先、ポスト先をダブルクリック
- 先のリクエストの完了を待たずに別リンクへ遷移
なお、これらのIOExceptionは、ゲートウェイによるクライアントアプリケーションのソケット切断の検出タイミング(ネットワークの状態によって異なる)とコンテナによるソケットへの書き出しタイミングに依存するため、必ず発生するものではありません。
アプリケーションの処理に時間がかかっている場合には、タイムアウト時間を長く設定してください。アプリケーションに問題があり、復帰しない、もしくは遅延している場合にはアプリケーションを見直してください。

javax.naming.InvalidNameException

［原因］
　Webアプリケーション環境定義ファイルのアプリケーション環境エントリの<env-ref-name>タグ、または値が省略されています。

［ユーザの対処］
　Webアプリケーション環境定義ファイルを修正してください。
　詳細は、“J2EEユーザーズガイド"の"Webアプリケーション環境定義ファイル(deployment descriptor)"の"アプリケーション環境エントリ"を参照してください。

javax.naming.NameAlreadyBoundException

［原因］

Webアプリケーション環境定義ファイルの<resource-ref>タグを複数定義した際に<res-ref-name>タグの値が重複しています。
Webアプリケーション環境定義ファイルの<env-entry>タグを複数定義した際に<env-ref-name>タグの値が重複しています。

［ユーザの対処］

Webアプリケーション環境定義ファイルを修正してください。詳細は、"J2EEユーザーズガイド"の"Webアプリケーション定義ファイル(deployment descriptor)"の"外部リソースの参照"を参照してください。
Webアプリケーション環境定義ファイルを修正してください。詳細は、"J2EEユーザーズガイド"の"Webアプリケーション定義ファイル(deployment descriptor)"の"アプリケーション環境エントリ"を参照してください。

javax.naming.NamingException

［原因］
　Webアプリケーション環境定義ファイルのアプリケーション環境エントリの以下のタグ、または値が省略されています。

<env-ref-value>タグ
<env-ref-type>タグ

［ユーザの対処］
　Webアプリケーション環境定義ファイルを修正してください。詳細は、"J2EEユーザーズガイド"の"Webアプリケーション定義ファイル(deployment descriptor)"の"アプリケーション環境エントリ"を参照してください。

jasper.compiler.ParseException

［原因］
　JSPの文法誤りです。

［ユーザの対処］
　JSPのアプリケーションを修正してください。

jasper.JasperException

［原因］

JSPのアプリケーションに記述されたスクリプト(Java)の文法誤りです。
JSPから呼び出したクラスのメソッドでExceptionが発生しました。

［ユーザの対処］

アプリケーションを修正してください。
呼び出し先メソッドを修正してください。

NoClassDefFoundError

［原因］

実行しようとしたクラスファイルが見つかりません。
アプリケーション・コンパイル時のJDKの環境と、アプリケーション実行時のJDKの環境が異なります。
クラスまたはメソッド名の指定で大文字・小文字が異なります。
コンテナの標準出力、標準エラー出力のログに以下のメッセージが出力された場合には、“起動ログおよびコンテナの標準出力、標準エラー出力のログメッセージ”を参照してください。
java.lang.NoClassDefFoundError: com/fujitsu/interstage/jservlet/tomcat/startup/TomcatException in thread "main"
または
java.lang.NoClassDefFoundError: org/xml/sax/DocumentHandler
または
java.lang.NoClassDefFoundError: javax/servlet/ServletRequest
セキュリティ機能またはオブジェクト参照機能がJDK1.2で使用されています。

［ユーザの対処］

CLASSPATHの設定を見直してください。
アプリケーションをコンパイルしたJDKのバージョンとサーブレット・コンテナが動作するJDKのバージョンを同じにしてください。JDKのバージョン指定は、"J2EEユーザーズガイド"の"JServlet環境定義ファイル"の"default.binまたは[containername].bin"を参照してください。
または、サーブレット・コンテナのJDKの環境に合わせてアプリケーションを再コンパイルしてください。
アプリケーションの呼び出し部分を正しいクラス／メソッド名に修正してください。
セキュリティ機能またはオブジェクト参照機能はJDK1.3以上を使用してください。

NoSuchElementException

［原因］
　アプリケーション・コンパイル時のJDKの環境と、アプリケーション実行時のJDKの環境が異なります。

［ユーザの対処］
　アプリケーションをコンパイルしたJDKのバージョンとサーブレット・コンテナが動作するJDKのバージョンを同じにしてください。JDKのバージョン指定は、"J2EEユーザーズガイド"の"JServlet環境定義ファイル"の"default.binまたは[containername].bin"を参照してください。または、サーブレット・コンテナのJDKの環境に合わせてアプリケーションを再コンパイルしてください。

NullPointerException

［原因］

アプリケーションに誤りがあります。
必要なクラスがJServlet環境定義に指定されていません。
コンテナの標準出力、標準エラー出力のログに以下のメッセージが出力された場合には、“起動ログおよびコンテナの標準出力、標準エラー出力のログメッセージ”を参照してください。
ERROR reading (<filename>) java.lang.NullPointerException:
At Line <number> <web-app-id>

ERROR reading <filename>
At com.sun.xml.parser/P-<number>

FATAL: configuration error
java.lang.NullPointerException:

HANDLER THREAD PROBLEM:
java.lang.NullPointerException

［ユーザの対処］

本メッセージに続いて出力されているスタックトレースを解析し、アプリケーションの以下の問題を修正してください。
オブジェクトが必要な場合に、アプリケーションがnullを使おうとするとスローされるもので、以下のようなケースがないか確認してください。
- nullオブジェクトのインスタンスメソッドの呼び出し
- nullオブジェクトのフィールドに対するアクセスまたは変更
- nullの長さを配列であるかのように取得
- nullをThrowable値であるかのようにスロー
JServlet環境定義ファイルに必要なクラスパスを追加してください。
クラスパスの設定は、“J2EEユーザーズガイド"の"JServlet環境定義ファイル"のdefault.envまたは[containername].env"を参照してください。

OutOfMemoryError

［原因］

Java VMのヒープ領域の不足です。
Java VMのパーム(permanent)領域の不足です。
システムのメモリ不足です。

［ユーザの対処］

Java VMの最大ヒープ領域のサイズを増やしてください。
ヒープ領域の利用状況については、Java VMの起動パラメタに“-verbosegc”オプションを追加することによりガベージコレクション発生時のヒープ利用状況を測定できます。
環境設定については、"J2EEユーザーズガイド"の"JServlet環境定義ファイル"の"default.bin.parametersまたは[containername].bin.parameters"を参照してください。
Java VMの起動オプションについては、Java VMのドキュメントを参照してください。
ヒープ領域に空きがあるにもかかわらず、本メッセージが出力される場合には、パーム(permanent)領域が不足していることが考えられます。Java VMのパーム領域のサイズを増やしてください。
パーム領域のサイズは、“JServlet環境定義ファイル”の“default.bin.parametersまたは[containername].bin.parameters”で、Java VMのオプションに指定します。
Java VMのオプションについては、Java VMのドキュメントを参照してください。
現在起動しているServletサービス以外の不用なアプリケーションを終了してください。"インストールガイド"を参照して必要となるメモリが十分に用意されているか確認してください。メモリ量が不足しているときには、メモリを増設してください。

ServletException

［原因］
　サーブレット内部でExceptionが発生しました。

［ユーザの対処］
　このExceptionの後に出力されている「Root cause:」のExceptionの対処を行ってください。

SocketException

［原因］

サーブレット・ゲートウェイとサーブレット・コンテナ間のソケットが切断されました。
ServletまたはJSPと、サーバアプリケーション間のソケットが切断されました。
サーバアプリケーションがダウンしました。
コンテナの標準出力、標準エラー出力のログに以下のメッセージが出力された場合には、“起動ログおよびコンテナの標準出力、標準エラー出力のログメッセージ”を参照してください。
HANDLER THREAD PROBLEM:
java.net.SocketException: Connection reset by peer: JVM_recv in socket input stream read

FATAL: java.net.SocketException: create (code=xxxxx)
java.net.SocketException: create (code=xxxxx)

［ユーザの対処］

アプリケーションの処理を見直してください。妥当である場合は、サーブレット・ゲートウェイのタイムアウト時間を長くしてください。
アプリケーションの処理を見直してください。妥当である場合は、アプリケーションで使用しているソケットのタイムアウト時間を長くしてください。
サーバアプリケーションの状態を確認してください。また、必要があればサーバアプリケーションを修正してください。

UnsatisfiedLinkError

［原因］

JNI(Java Native Interface)で呼び出すDLLがPATHに設定されていません。
nativeメソッド宣言のjavaソースとCヘッダの不整合です。
JNI呼び出しクラスと、JNIをロードするloadLibraryメソッドを呼び出しているクラスの配置が異なっています。
リロードによりJNIが呼び出し不可能になりました。

［ユーザの対処］

JServlet環境定義ファイルにJNIで呼び出すDLLを環境変数PATHに指定してください。
設定については、“J2EEユーザーズガイド"の"JServlet環境定義ファイル"の"default.envまたは[containername].env"を参照してください。
アプリケーションのコンパイル環境を見直してください。
JNI呼び出しクラスと、loadLibraryメソッドを呼び出しているクラスは同じ場所に配置してください。以下のどちらか1つの場所に配置してください。
- クラスパスに配置する場合
  JServlet環境定義ファイルのクラスパス
- Webアプリケーション配下に配置する場合
  Webアプリケーションのディレクトリ/WEB-INF/classes
  Webアプリケーションのルートディレクトリ/WEB-INF/lib
リロード機能を無効にしてください。または、JNI呼び出しクラスと、loadLibraryメソッドを呼び出しているクラスはJServlet環境定義ファイルのクラスパスに配置してください。