legacy-knowledge-base
公開されました Jul. 2, 2025

ポートレット、フックなどのデプロイ時に 'org.dom4j.DocumentException' による接続タイムアウトが発生する。

投稿者

Gustavo Vasconcelos

knowledge-article-header-disclaimer-how-to

knowledge-article-header-disclaimer

legacy-article

learn-legacy-article-disclaimer-text

Liferay Supportは、特定のサードパーティ製品を他の製品よりも推奨または承認するものではありません。 Liferayは、これらの製品に関して、ここに記載または参照されているいかなる指示に対しても責任を負いません。 これらの原則の実行は、加入者の責任において行われるものとします。

フック、ポートレット、テーマなど、ある種のプラグインのデプロイに何度も失敗する環境がある。 その場合、以下のようなスタックトレースがログに表示されます。

13:33:06,568 ERROR [localhost-startStop-1][HotDeployImpl:111] com.liferay.portal.kernel.deploy.hot.HotDeployException: Error registering hook for calendar-language-fix-hook
com.liferay.portal.kernel.deploy.hot.HotDeployException: Error registering hook for calendar-language-fix-hook
	at com.liferay.portal.kernel.deploy.hot.BaseHotDeployListener.throwHotDeployException(BaseHotDeployListener.java:46)
	at com.liferay.portal.deploy.hot.HookHotDeployListener.invokeDeploy(HookHotDeployListener.java:280)

(...)

	at java.lang.Thread.run(Thread.java:745)
Caused by: com.liferay.portal.kernel.xml.DocumentException: Connection timed out Nested exception: Connection timed out
	at com.liferay.portal.xml.SAXReaderImpl.read(SAXReaderImpl.java:428)
	at com.liferay.portal.xml.SAXReaderImpl.read(SAXReaderImpl.java:446)
	at sun.reflect.GeneratedMethodAccessor245.invoke(Unknown Source)
	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
	at java.lang.reflect.Method.invoke(Method.java:606)
	at com.liferay.portal.security.lang.DoPrivilegedHandler.doInvoke(DoPrivilegedHandler.java:88)
	at com.liferay.portal.security.lang.DoPrivilegedHandler.invoke(DoPrivilegedHandler.java:56)
	at com.sun.proxy.$Proxy76.read(Unknown Source)
	at com.liferay.portal.kernel.xml.SAXReaderUtil.read(SAXReaderUtil.java:187)
	at com.liferay.portal.deploy.hot.HookHotDeployListener.doInvokeDeploy(HookHotDeployListener.java:592)
	at com.liferay.portal.deploy.hot.HookHotDeployListener.invokeDeploy(HookHotDeployListener.java:277)
	... 30 more
Caused by: org.dom4j.DocumentException: Connection timed out Nested exception: Connection timed out
	at org.dom4j.io.SAXReader.read(SAXReader.java:484)
	at org.dom4j.io.SAXReader.read(SAXReader.java:365)
	at com.liferay.portal.xml.SAXReaderImpl.read(SAXReaderImpl.java:425)
	... 40 more

キーアイテムは、文字列 org.dom4j.DocumentException を含む行です:接続がタイムアウトしました. このような場合、ポータルサイトが稼動しているサーバーがインターネットに接続されていない、アクセスに障害がある、または liferay-*.xml のDTD(文書型定義)ファイルが保存されているサーバーにアクセスできないことが原因であると考えられます。 これにより、Liferay Portalはドキュメントのバリデーションに失敗し、デプロイ処理を中止します。

解像度

接続エラーが一過性のものである場合、WARの配置を再試行すると、最終的にうまくいくことがあります。 しかし、サーバーがインターネットに接続されていない一般的なシナリオでは、いずれかの方法で進めるのがよいでしょう:

  1. XML 検証の無効化 portal-ext.properties xml.validation.enabled の値を false に変更する
    1. xml.validation.enabled=false
  2. プラグイン内のすべてのliferay-*.xmlファイルから<!DOCTYPE>要素行を削除してください。
    1. liferay-look-and-feel.xml
    2. liferay-hook
    3. liferay-display.xml
    4. liferay-portlet.xml、など。
  3. これは、オフラインのポータルでプラグインが展開可能であることを確認したい場合にのみ実行する必要があります。
did-this-article-resolve-your-issue

legacy-knowledge-base