Knife4j 文件上传 multipart/data 同时接受文件和对象,调试时上传文件失效

复制代码
PrizeCreateParam 自定义的java对象 还有 MultipartFile

当二者同时使用RequestPart注解后, 按理来说 knife4j页面应该是 可以显示 文件上传和json填写的

这里prizePic的请求类型是Query显然是错的,因为文件上传不能在url里面

我的knife4j是 4.4.0版本

复制代码
<dependency>
   <groupId>com.github.xiaoymin</groupId>
   <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
   <version>4.4.0</version>
</dependency>

AI的核心修改思路是:

通过 Swagger 注解明确声明每个参数的媒体类型,让 Knife4j 知道「哪个参数是文件、哪个参数是 JSON 对象」,但是AI修改后 主要是 使用Parameter注解,而且生成的代码修改非常长,给接口补充精准的 OpenAPI 3 注解,明确标记每个参数的类型和媒体类型

解决方案:

无意在GitHub上发现了个大佬的解决方案,虽然不是很完美,但是用了很少的代码就 实现了原本的功能

经过试验发现确实是有效的

但是最终展示出的效果 并不是以JSON格式的填写,而是以FROM表单格式的填写方式

可以肯定的是这个就是BUG

是 Knife4j 4.x 对 OpenAPI3 的 multipart 解析问题 :当接口使用 @RequestPart JSON对象 + @RequestPart MultipartFile 时

springdoc 生成的 OpenAPI 是正确的(multipart/form-data 下的 object schema)

原生 Swagger UI 能正常显示"文件选择按钮 + JSON 输入框";

但 Knife4j 在二次解析文档时,没有把 JSON 对象正确放进 multipart 的 schema 里,而是当成普通 body 或参数处理,导致文件类型被降级成文本框或变成 raw/query 参数

所以表现异常------不是你的 Controller 写错,而是 Knife4j 4.x 的解析兼容问题。

相关推荐
星落梦生7 小时前
SpringAOP基础笔记(7)
java·开发语言
金銀銅鐵8 小时前
带您看懂字节码指令(四):一条指令里有什么
java·jvm
最强小杰9 小时前
某 OpenAI 兼容网关上的 `kimi-k3.1-pro`:Cline、Zed 接入与 SSE 排错示例
java·服务器·网络·ai
Flynn Liang9 小时前
流量治理不是限流那么简单:I/O 密集型 Java 服务的 6 层防线
java·微服务·高并发·限流·熔断·系统稳定性·resilience4j
学长毕设9 小时前
基于SpringBoot智慧养老服务平台设计与实现-附源码
java·spring boot·后端
曹牧10 小时前
Java:“刷新雪崩”
java·开发语言
秋天的怀念_David10 小时前
算法一千零一夜 · 第三十三夜 · 跳表
java·程序人生·算法
Forget the Dream11 小时前
Spring AI 2.0 系列(二):第一个 ChatClient——从注入到一次完整调用
java·人工智能·spring boot·ai·springai
黑十13 小时前
FDE 怎么快速搭一个可演示页面?最小前端方案
java·大数据·前端·数据库·人工智能
神明不懂浪漫13 小时前
【第八章】多线程(一)
java·开发语言·经验分享·笔记