Springfox: Parameter respons @ApiResponse tidak digunakan dalam 3.0.0

Dibuat pada 17 Agu 2020 · 6Komentar · Sumber: springfox/springfox

Dimulai dengan 3.0.0 (di 2.9.2 ini bekerja dengan baik)

@ApiResponse(code = 404, message = "Not Found", response = CustomError::class)

404 - Not Found ada dalam dokumentasi, tetapi respon yang ditentukan (CustomError dalam contoh) tidak ditampilkan dalam dokumentasi yang dihasilkan (contoh dan model respon)

bug

Sumber

varjasz

👍6

Komentar yang paling membantu

Untuk mengatasinya sekarang, tambahkan: springfox.documentation.swagger.use-model-v3 = false

Solusi yang ditentukan tampaknya tidak berhasil untuk jenis pengembalian ResponseEntity<?> . Saya tidak yakin apakah itu masalah terpisah atau jika itu bagian tak terpisahkan dari bug ini.

drognisep pada 19 Jan 2021

👍3

Semua 6 komentar

@ varjasz apakah Anda menemukan solusi?

danielfelgar pada 21 Agu 2020

@ varjasz apakah Anda menemukan solusi?

Tidak, tapi saya tidak mencarinya.

varjasz pada 23 Agu 2020

Terima kasih telah melaporkan @varjasz

dilipkrish pada 24 Agu 2020

Masalah yang sama di sini.
Setelah beberapa proses debug, akar penyebabnya adalah: https://github.com/springfox/springfox/blob/07a4c86d70b791f21c2d2f656a863920b8c883c7/springfox-swagger2/src/main/java/springfox/docava

Springfox 3.0 menggunakan model v3 secara default, tetapi source.getResponses() memberikan tipe yang salah. Untuk mengatasinya sekarang, tambahkan:
springfox.documentation.swagger.use-model-v3=false dalam properti.aplikasi Anda.

gonwan pada 1 Sep 2020

👍3

Untuk mengatasinya sekarang, tambahkan: springfox.documentation.swagger.use-model-v3 = false

Solusi yang ditentukan tampaknya tidak berhasil untuk jenis pengembalian ResponseEntity<?> . Saya tidak yakin apakah itu masalah terpisah atau jika itu bagian tak terpisahkan dari bug ini.

drognisep pada 19 Jan 2021

👍3

Saya dapat mengonfirmasi perbaikan dengan springfox.documentation.swagger.use-model-v3=false untuk jenis dokumen DocumentationType.SWAGGER_2 .

Di sisi lain, bukankah seharusnya itu berhasil di luar kotak dengan jenis dokumen DocumentationType.OAS_30 ? Saya mencobanya dengan dan tanpa pengaturan app.prop tetapi berperilaku sama dengan masalah awal dengan tidak muncul sama sekali.