Knife4j解决SpringBoot整合Knife4j 3.0.3 文件上传不显示文件域

Posted 2021-12-23 小雨青年

一、环境版本

• SpringBoot 2.5.2
• Knife4j 3.0.3

二、问题

使用Knife4j用来配置接口文档注解的时候，文件上传加不上去，使用注解@ApiParam的type或者format都不行。

三、解决方案

先看源码，位置在/Users/diandianxiyu_geek/.m2/repository/org/springframework/spring-web/5.3.8/spring-web-5.3.8.jar!/org/springframework/web/bind/annotation/RequestPart.class。

package org.springframework.web.bind.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import org.springframework.core.annotation.AliasFor;

@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface RequestPart 
    @AliasFor("name")
    String value() default "";

    @AliasFor("value")
    String name() default "";

    boolean required() default true;

控制器用法如下，亲测可用。

    @ApiOperation(value = "导入")
    @PostMapping("/import")
    public void importFile(@RequestPart @RequestParam("file") MultipartFile file)
        
    

最后生成的文档如下。