swagger-annotations api dependency conflicts with swagger-annotations-jakarta
メンテナーはふだん 1 日以内に返信
評価
- 難易度
- 3/5
- 見積もり時間
- 1〜2日
- 初心者へのやさしさ
- 58/100
- issue の種類
- バグ
- 明瞭さ
- おおむね明確
- 活発さ
- 静か
- 技術スタック
- kotlin
- 領域
- build-system
調査の方向性
openai-java-core/build.gradle.kts から始めて、swagger-annotations がどのように公開されているかを確認し、続いて structured output のスキーマ統合とその依存関係メタデータを確認します。公開されている依存関係グラフと照合して変更を確認し、swagger-annotations-jakarta を使用するコンシューマーが javax 向けのアーティファクトを強制的に受け取ることなく、ドキュメント化されたスキーマアノテーションが引き続きサポートされるようにします。
索引モデルが issue の本文から書いたものです。
説明
Description
openai-java-core declares:
api("io.swagger.core.v3:swagger-annotations:2.2.31")
(openai-java-core/build.gradle.kts)
This pulls the javax-oriented Swagger annotations artifact onto every consumer classpath as a hard dependency.
Many Jakarta EE / Spring Boot 3 applications already depend on io.swagger.core.v3:swagger-annotations-jakarta (e.g. via springdoc-openapi). Those two artifacts are mutually exclusive: they share the package io.swagger.v3.oas.annotations, so having both on the classpath causes duplicate-class / split-package conflicts.
Why this is surprising
The SDK itself does not need these annotations at compile time for its own types. Structured Outputs uses com.github.victools:jsonschema-module-swagger-2, which already declares swagger-annotations as provided. The annotations are only needed when consumers annotate their schema classes with @Schema / @ArraySchema (as documented in the README).
Re-exporting them as api is convenient, but it forces one of two incompatible coordinates onto ecosystems that already chose the other.
Workaround
Exclude the transitive dependency and keep the jakarta artifact:
<dependency>
<groupId>com.openai</groupId>
<artifactId>openai-java</artifactId>
<exclusions>
<exclusion>
<groupId>io.swagger.core.v3</groupId>
<artifactId>swagger-annotations</artifactId>
</exclusion>
</exclusions>
</dependency>
implementation("com.openai:openai-java:…") {
exclude(group = "io.swagger.core.v3", module = "swagger-annotations")
}
Environment
- Consumer using
swagger-annotations-jakarta(Spring Boot 3 / springdoc) - openai-java bringing
swagger-annotationsviaopenai-java-core
- 主要言語
- Kotlin
- スター
- 1.5k
- フォーク
- 266
- 平均マージ
- 10時間 11分
- マージ済み PR（30日）
- 141
環境構築
このプロジェクトの開発コンテナを、あなたの GitHub アカウントでブラウザ上に起動します。
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートなし
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
openai/openai-java のほかの issue
-
HttpRequest.url() logs spaces in path segments as literal plus signs対応中かも @sylvesterkaczmarek が 55 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
openai/openai-java#886 · コメント 2 件 ·
メンテナーはふだん 1 日以内に返信
-
Make diarized transcription duration and task optional対応中かも @wskr00 が 85 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
openai/openai-java#802 · コメント 2 件 · リアクション 3 件 ·
メンテナーはふだん 1 日以内に返信
-
難易度 3/5 半日 初心者へのやさしさ 42/100
openai/openai-java#1160 ·
メンテナーはふだん 1 日以内に返信
-
AsyncStreamResponse can hang when the subscriber executor rejects work対応中かも @sylvesterkaczmarek が 38 日前に担当しました。 オープン
難易度 3/5 1〜2日 初心者へのやさしさ 74/100
openai/openai-java#973 ·
メンテナーはふだん 1 日以内に返信
-
難易度 5/5 1週間以上 初心者へのやさしさ 35/100
openai/openai-java#956 ·
メンテナーはふだん 1 日以内に返信
openai/openai-java の issue をすべて見る
似ている issue
-
afk-ok area:data-quality importer size:S
難易度 2/5 1〜3時間 初心者へのやさしさ 77/100
enorm-labs/event-junkie#3166 ·
メンテナーはふだん 1 日以内に返信
-
bugbane/qf good first issue
難易度 2/5 1〜3時間 初心者へのやさしさ 64/100
osservatorionessuno/bugbane#173 ·
メンテナーはふだん 1 日以内に返信
-
Android: build fails with Android Gradle Plugin 9 (kotlinOptions, lintOptions, proguard-android.txt)オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
capacitor-community/stripe#544 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
-
documentation
難易度 2/5 1〜3時間 初心者へのやさしさ 66/100
theopenconversationkit/tock#2113 ·
メンテナーはふだん 1 日以内に返信