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

アップグレード処理でMETA-INF/portal-hbm.xmlの読み込み中にDocumentExceptionが発生する。

投稿者

Cristina Rodriguez

knowledge-article-header-disclaimer-how-to

knowledge-article-header-disclaimer

legacy-article

learn-legacy-article-disclaimer-text

問題

  • Gogo Shellからコマンド upgrade:run または upgrade:runAllを使用してアップグレード処理を実行すると、ある時点でDocumentExceptionがスローされることがある。
  • upgrade.log に以下のようなスタックトレースが表示されます:
com.liferay.portal.kernel.upgrade.UpgradeException: com.liferay.portal.kernel.xml.DocumentException

{...}

Caused by: com.liferay.portal.kernel.xml.DocumentException
at com.liferay.portal.xml.SAXReaderImpl.read(SAXReaderImpl.java:372)
at com.liferay.portal.xml.SAXReaderImpl.read(SAXReaderImpl.java:346)
at com.liferay.portal.kernel.xml.UnsecureSAXReaderUtil.read(UnsecureSAXReaderUtil.java:46)
at com.liferay.portal.kernel.upgrade.UpgradeMVCCVersion.getClassElements(UpgradeMVCCVersion.java:98)

Environment

  • どのようなアップグレードプロセスでも再現可能です。

解決策

    • このエラーは、Gogoシェルから何らかの保留中のアップグレード処理を実行した場合に確認されています。
    • サーバーを停止し、提供されたスクリプトで保留中のプロセスを実行します db_upgrade.sh. こうすることで、例外が投げられなくなるはずです。

追加情報

did-this-article-resolve-your-issue

legacy-knowledge-base