Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

1.8. 既知の問題

Red Hat build of Quarkus 3.8 の制限事項と回避策は、次の既知の問題を確認してください。

1.8.1. Infinispan クライアントエクステンションは、FIPS および Native Mandrel 23.1 で動作しません
リンクのコピー

ネイティブモードでは、registry.redhat.io/quarkus/mandrel-for-jdk-21-rhel8 からの Red Hat build of Quarkus 3.8 用のネイティブビルダーコンテナーを使用している場合、ネイティブモードでは Red Hat build of Quarkus Infinispan クライアントエクステンションが Federal Information Processing Standards (FIPS) 対応システム上で動作しません。

回避策: このネイティブ Image Builder ではネイティブモードを使用しないでください。現時点で使用できる回避策はありません。

1.8.2. Strimzi OAuth クライアントを 0.14.0 に更新するとネイティブビルドが失敗する
リンクのコピー

Strimzi OAuth クライアントでは、io.strimzi:strimzi-kafka-oauth 依存関係が 0.14.0 に更新されたために既知の問題が発生し、次のエラーで示されるネイティブビルドのエラー Substitution target for io.smallrye.reactive.kafka.graal.Target_com_jayway_jsonpath_internal_DefaultsImpl is not loaded. が発生します。

回避策: この問題を回避するには、クラスパスに io.strimzi:kafka-oauth-common 依存関係を含めます。

1.8.3. AArch64 上の Kafka Streams エクステンションのネイティブライブラリーが見つからない
リンクのコピー

quarkus-kafka-streams エクステンションを使用するアプリケーションは、ネイティブライブラリー librocksdbjni-linux-AArch64.so がないため、AArch64 システムで実行時エラーが発生します。この問題により、アプリケーションの起動時に java.lang.RuntimeException: librocksdbjni-linux-AArch64.so was not found inside JAR エラーが出力されます。このエラーにより、Kafka Streams アプリケーションにとって重要な RocksDB コンポーネントの正常な初期化が妨げられます。

回避策: 現時点では回避策はありません。

例 java.lang.RuntimeException: librocksdbjni-linux-AArch64.so エラー

09:32:54,059 INFO  [app] ERROR: Failed to start application (with profile [prod])
09:32:54,059 INFO  [app] java.lang.RuntimeException: Failed to start quarkus
09:32:54,060 INFO  [app] 	at io.quarkus.runner.ApplicationImpl.doStart(Unknown Source)
09:32:54,060 INFO  [app] 	at io.quarkus.runtime.Application.start(Application.java:101)
09:32:54,060 INFO  [app] 	at io.quarkus.runtime.ApplicationLifecycleManager.run(ApplicationLifecycleManager.java:111)
09:32:54,061 INFO  [app] 	at io.quarkus.runtime.Quarkus.run(Quarkus.java:71)
09:32:54,061 INFO  [app] 	at io.quarkus.runtime.Quarkus.run(Quarkus.java:44)
09:32:54,061 INFO  [app] 	at io.quarkus.runtime.Quarkus.run(Quarkus.java:124)
09:32:54,062 INFO  [app] 	at io.quarkus.runner.GeneratedMain.main(Unknown Source)
09:32:54,062 INFO  [app] Caused by: java.lang.ExceptionInInitializerError
09:32:54,063 INFO  [app] 	at io.quarkus.kafka.streams.runtime.KafkaStreamsRecorder.loadRocksDb(KafkaStreamsRecorder.java:14)
09:32:54,063 INFO  [app] 	at io.quarkus.deployment.steps.KafkaStreamsProcessor$loadRocksDb1611413226.deploy_0(Unknown Source)
09:32:54,063 INFO  [app] 	at io.quarkus.deployment.steps.KafkaStreamsProcessor$loadRocksDb1611413226.deploy(Unknown Source)
09:32:54,064 INFO  [app] 	... 7 more
09:32:54,064 INFO  [app] Caused by: java.lang.RuntimeException: librocksdbjni-linux-AArch64.so was not found inside JAR.
09:32:54,065 INFO  [app] 	at org.rocksdb.NativeLibraryLoader.loadLibraryFromJarToTemp(NativeLibraryLoader.java:118)
09:32:54,065 INFO  [app] 	at org.rocksdb.NativeLibraryLoader.loadLibraryFromJar(NativeLibraryLoader.java:102)
09:32:54,065 INFO  [app] 	at org.rocksdb.NativeLibraryLoader.loadLibrary(NativeLibraryLoader.java:82)
09:32:54,066 INFO  [app] 	at org.rocksdb.RocksDB.loadLibrary(RocksDB.java:70)
09:32:54,066 INFO  [app] 	at org.rocksdb.RocksDB.<clinit>(RocksDB.java:39)
09:32:54,067 INFO  [app] 	... 10 more
Copy to Clipboard Toggle word wrap

Microsoft Windows で quarkus-kafka-streams エクステンションを使用するアプリケーションでは、ネイティブライブラリー librocksdbjni-win64.dll がないため、実行時エラーが発生します。この問題により、アプリケーションの起動プロセス中に java.lang.RuntimeException: librocksdbjni-win64.dll was not found inside JAR エラーが発生します。

このエラーにより、Kafka Streams アプリケーションにとって重要な RocksDB コンポーネントの正常な初期化が妨げられます。

回避策: 現時点では回避策はありません。

例 java.lang.RuntimeException: librocksdbjni-win64.dll error

13:07:08,118 INFO  [app] ERROR: Failed to start application (with profile [prod])
13:07:08,118 INFO  [app] java.lang.RuntimeException: Failed to start quarkus
13:07:08,118 INFO  [app] 	at io.quarkus.runner.ApplicationImpl.doStart(Unknown Source)
13:07:08,118 INFO  [app] 	at io.quarkus.runtime.Application.start(Application.java:101)
13:07:08,118 INFO  [app] 	at io.quarkus.runtime.ApplicationLifecycleManager.run(ApplicationLifecycleManager.java:111)
13:07:08,118 INFO  [app] 	at io.quarkus.runtime.Quarkus.run(Quarkus.java:71)
13:07:08,118 INFO  [app] 	at io.quarkus.runtime.Quarkus.run(Quarkus.java:44)
13:07:08,118 INFO  [app] 	at io.quarkus.runtime.Quarkus.run(Quarkus.java:124)
13:07:08,118 INFO  [app] 	at io.quarkus.runner.GeneratedMain.main(Unknown Source)
13:07:08,118 INFO  [app] Caused by: java.lang.ExceptionInInitializerError
13:07:08,118 INFO  [app] 	at io.quarkus.kafka.streams.runtime.KafkaStreamsRecorder.loadRocksDb(KafkaStreamsRecorder.java:14)
13:07:08,118 INFO  [app] 	at io.quarkus.deployment.steps.KafkaStreamsProcessor$loadRocksDb1611413226.deploy_0(Unknown Source)
13:07:08,118 INFO  [app] 	at io.quarkus.deployment.steps.KafkaStreamsProcessor$loadRocksDb1611413226.deploy(Unknown Source)
13:07:08,118 INFO  [app] 	... 11 more
13:07:08,118 INFO  [app] Caused by: java.lang.RuntimeException: librocksdbjni-win64.dll was not found inside JAR.
13:07:08,118 INFO  [app] 	at org.rocksdb.NativeLibraryLoader.loadLibraryFromJarToTemp(NativeLibraryLoader.java:118)
13:07:08,118 INFO  [app] 	at org.rocksdb.NativeLibraryLoader.loadLibraryFromJar(NativeLibraryLoader.java:102)
13:07:08,118 INFO  [app] 	at org.rocksdb.NativeLibraryLoader.loadLibrary(NativeLibraryLoader.java:82)
13:07:08,118 INFO  [app] 	at org.rocksdb.RocksDB.loadLibrary(RocksDB.java:70)
13:07:08,118 INFO  [app] 	at org.rocksdb.RocksDB.<clinit>(RocksDB.java:39)
13:07:08,118 INFO  [app] 	... 14 more
Copy to Clipboard Toggle word wrap

1.8.5. ネイティブビルド中に Vert.x クラスが欠落することの説明
リンクのコピー

ネイティブビルド中に、開発者は io.vertx.core.http.impl.Http1xServerResponse や io.vertx.core.parsetools.impl.RecordParserImpl などの Vert.x クラスに対して java.lang.ClassNotFoundException エラーを受け取る場合があります。これらのエラーは、直接的または推移的な依存関係として Vert.x を含めずに、quarkus-qpid-jms エクステンションを使用するアプリケーションを含むアプリケーションをビルドするときに発生します。

quarkus-qpid-jms は Vert.x を直接使用しないことを明確にすることが重要です。この問題は、quarkus-qpid-jms が使用する quarkus-netty エクステンションから発生します。quarkus-netty エクステンションは、ネイティブビルド中にこれらの Vert.x クラスをランタイム初期化用に登録するロールを担いますが、その存在は確認されません。これにより、ビルド内に Vert.x を導入する他のエクステンションがない場合に、前述の例外が発生します。

これらの ClassNotFoundException エラーはビルドプロセス中にログに記録されますが、アプリケーションの機能には影響しません。これらは、ネイティブビルドプロセスと、Red Hat build of Quarkus 内で依存関係が処理される方法 (具体的には quarkus-netty モジュール経由) の結果です。

java.lang.ClassNotFoundException エラーの例

java.lang.ClassNotFoundException: io.vertx.core.http.impl.Http1xServerResponse
	at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641)
	at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:188)
	at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:526)
	at org.graalvm.nativeimage.builder/com.oracle.svm.hosted.NativeImageClassLoader.loadClass(NativeImageClassLoader.java:652)
	... (further stack trace details)
java.lang.ClassNotFoundException: io.vertx.core.parsetools.impl.RecordParserImpl
	at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641)
	at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:188)
	at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:526)
	at org.graalvm.nativeimage.builder/com.oracle.svm.hosted.NativeImageClassLoader.loadClass(NativeImageClassLoader.java:652)
	... (further stack trace details)
Copy to Clipboard Toggle word wrap

回避策: これらのログエントリーを防ぎ、すべての依存関係が適切に認識されるようにするには、オプションでプロジェクトに quarkus-vertx エクステンションを追加できます。

1.8.6. OpenShift での JVM モードテストにおける AArch64 サポートの制限
リンクのコピー

Red Hat build of Quarkus 3.2 以降で稼働している AArch64 を使用した Red Hat OpenShift Container Platform 上の JVM モードのテストパイプラインには、AArch64 に関するいくつかの既知の制限があります。

  • Red Hat Serverless は AArch64 ではサポートされていません。AArch64 アーキテクチャーで実行している OpenShift クラスター上の Red Hat Serverless のサポートに関する機能要求は SRVCOM-2472 で追跡されており、Serverless 1.33 にサポートが組み込まれる予定です。
  • Red Hat AMQ Streams は AArch64 ではサポートされていません。AMQ Streams は AArch64 ではまだサポートされていないため、この統合のサポートはまだテストされていません。この問題は現在、Red Hat の問題管理システムでは追跡されていません。
  • Red Hat Single Sign-On は AArch64 ではサポートされていません。Red Hat Single Sign-On と Red Hat build of Keycloak はまだ AArch64 でサポートされていないため、Red Hat build of Quarkus アプリケーションとの統合はまだテストされていません。
  • Service Binding は AArch64 ではサポートされていません。Red Hat build of Quarkus とのサービスバインディング統合のテクノロジープレビューでサポートされているバインドされたサービスは、AArch64 ではまだサポートされていないため、この統合はまだテストされていません。さらに、OpenShift Service Binding Operator は OpenShift Container Platform (OCP) 4.13 以降では非推奨となり、将来の OCP リリースで削除される予定です。

AArch64 のサポートは Red Hat Universal Base Image (UBI) コンテナーに限定されており、ベアメタル環境には拡張されません。

回避策: 現時点では回避策はありません。

1.8.7. org.apache.maven:maven:pom:3.6.3 への依存によりプロキシーの問題が発生する可能性がある
リンクのコピー

org.apache.maven:maven:pom:3.6.3 への依存関係は、特定の Quarkus エクステンションを使用すると解決される可能性があります。これは Gradle プラグインに固有のものではありませんが、親 Project Object Model (POM) 階層に io.smallrye:smallrye-parent:pom:37 があるプロジェクトに影響します。この依存関係により、バージョン 3.6.x の org.apache.maven アーティファクトへのアクセスを制限するプロキシーの背後にある環境で、ビルドエラーが発生する可能性があります。Maven 3.6.3 のバイナリーパッケージは、Quarkus コアフレームワークまたはサポートされている Quarkus エクステンションの依存関係としてダウンロードされません。

回避策: 現時点では回避策はありません。

詳細は、QUARKUS-1025 - Gradle plugin drags in maven core 3.6.x を参照してください。

Red Hat build of Quarkus 3.8 では安定性が向上しました。また、ユーザーに大きな影響を与えるバグ修正が含まれています。

Red Hat ビルドの Quarkus の最新の修正を取得するには、利用可能な最新バージョンである 3.8.6.SP3-redhat⚙ を使用していることを確認してください。

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hatトップに戻る