はじめに
Quarkusのバージョンを上げた（3.4.1から3.15.2まで上げた）あと、quarkusDevでのアプリケーション起動時に↓のエラーが発生しました。
> :ma2025-03-02 16:00:35,049 ERROR [io.qua.dep.dev.IsolatedDevModeMain] (main) Failed to start quarkus: java.lang.RuntimeException: io.quarkus.builder.BuildException: Build failure: Build failed due to errorsUTING [18s]
[error]: Build step io.quarkus.resteasy.reactive.common.deployment.ResteasyReactiveCommonProcessor#checkMixingStacks threw an exception: jakarta.enterprise.inject.spi.DeploymentException: Mixing Quarkus REST and RESTEasy Classic server parts is not supported
at io.quarkus.resteasy.reactive.common.deployment.ResteasyReactiveCommonProcessor.checkMixingStacks(ResteasyReactiveCommonProcessor.java:108)
at java.base/java.lang.invoke.MethodHandle.invokeWithArguments(MethodHandle.java:733)
at io.quarkus.deployment.ExtensionLoader$3.execute(ExtensionLoader.java:856)
at io.quarkus.builder.BuildContext.run(BuildContext.java:256)
at org.jboss.threads.ContextHandler$1.runWith(ContextHandler.java:18)
at org.jboss.threads.EnhancedQueueExecutor$Task.doRunWith(EnhancedQueueExecutor.java:2516)
at org.jboss.threads.EnhancedQueueExecutor$Task.run(EnhancedQueueExecutor.java:2495)
at org.jboss.threads.EnhancedQueueExecutor$ThreadBody.run(EnhancedQueueExecutor.java:1521)
at java.base/java.lang.Thread.run(Thread.java:1583)
at org.jboss.threads.JBossThread.run(JBossThread.java:483)
これを解決したときの書き残しです。
原因
エラーメッセージにあるMixing Quarkus REST and RESTEasy Classic server parts is not supportedが原因です。
つまり、従来のRESTEasy Classicと、より新しい実装であるQuarkus RESTの混在はサポートされていないよ、ということです。
Quarkus RESTへの移行について、詳しいことはQuarkus公式のドキュメントにも書いてあります
登場人物を整理しておきます。
| name | artifact id | description |
|---|---|---|
| RESTEasy Classic | quarkus-resteasy | 従来のJakarta REST（JAX-RS）仕様の実装 |
| Quarkus REST | quarkus-rest | 新しいJakarta REST仕様の実装 |
| RESTEasy Reactive | quarkus-resteasy-reactive | 新しいJakarta REST仕様の実装。 今はQuarkus RESTに名前が変わっている |
混在の禁止
RESTEasy ClassicとQuarkus RESTの混在が明確に禁止されたのはQuarkus 3.9からです。ちなみにRESTEasy ReactiveがQuarkus RESTにリネームされたのもこのタイミングです。
今回のバージョンアップでは3.9をまたいでいるので、禁止に引っかかってエラーが出たんですね。
修正方法
混在しているのがいけないので、その状態を正します。
その時書いていた依存関係（GradleのKotlin DSL）はこうでした。
implementation("io.quarkus:quarkus-rest-client")
implementation("io.quarkus:quarkus-rest-client-jackson")
implementation("io.quarkus:quarkus-resteasy")
implementation("io.quarkus:quarkus-resteasy-jackson")
quarkus-resteasy系は古いので、「Quarkus RESTへの移行」のドキュメントにも記載されていた通り、新しいquarkus-restに置き換えます。
つまりこうですね。
implementation("io.quarkus:quarkus-rest-client")
implementation("io.quarkus:quarkus-rest-client-jackson")
- implementation("io.quarkus:quarkus-resteasy")
- implementation("io.quarkus:quarkus-resteasy-jackson")
+ implementation("io.quarkus:quarkus-rest")
+ implementation("io.quarkus:quarkus-rest-jackson")
これで、新しいquarkus-restだけが使われるようになるので、問題解決しました！
それでも直らない場合は?
同じことをやったけど直らないんですが？というケースもあるかもしれません。
私は前述の対応で問題解消できているので、ここからは想像で書くことをお許しください。
考えられるのは、プロジェクトで直接指定している依存関係だけでなく、それに付随して自動的に追加されるライブラリ（つまり間接的に依存しているライブラリ）の中に、古いquarkus-resteasyが含まれている可能性があるということです。
どういうことか、というのは、下記のコマンドでdependenciesのタスクを実行してもらうのが分かりやすいと思います。
$ ./gradlew dependencies --configuration runtimeClasspath
なお、プロジェクトの規模が大きいと依存関係ツリーは膨大になり、見るのが結構大変なので、例えばquarkusあたりでgrepすれば少し楽になるかもしれません。この辺りのキーワードは適宜調整してください。
$ ./gradlew dependencies --configuration runtimeClasspath | grep quarkus
出力された依存関係のツリーの中に、新しいもの（quarkus-restまたはquarkus-resteasy-reactive）と古いもの（quarkus-resteasy）がどちらも存在していたら、やはり混在しているということが確認できます。
そこが確認できれば、どのライブラリがquarkus-resteasyを間接的に引き込んでいるのかを特定し、そのライブラリのバージョンを上げる、もしくは不要なものを削除することで解決できるはずです。
新しいライブラリへの移行の際は、（冒頭で示したドキュメントと同じですが、）「Quarkus RESTへの移行」も参考にしてみてください。