Feign 调用报 RequestParam.value() was empty on parameter 0

news2024/11/26 18:48:28

详细报错: FactoryBean threw exception on object creation; nested exception is java.lang.IllegalStateException: RequestParam.value() was empty on parameter 0

背景

最近在使用 @RequestParam、@RequestBody 注解定义 feign 接口的时候出现一些使用上的问题，造成调用方启动的时候会报错。

详细情况

第一种情况，如下：

@PostMapping(value = "/hello2")
BetaDto hello2(String name1);

接口有且只有一个 key/value 参数，此时可以不必在 name1 参数上使用 @RequestParam 注解。通过 Feign 调用该接口的调用方可以正常启动。

第二种情况，如下：

@PostMapping(value = "/hello2")
BetaDto hello2(@RequestParam String name1);

接口有且只有一个 key/value 参数，此时如果对 name1 参数上使用 @RequestParam 注解，此时通过 Feign 调用该接口的调用方可启动的时候回抛出如下错误：

Caused by: java.lang.IllegalStateException: RequestParam.value() was empty on parameter 0

意思是 @RequestParam 的 value 值不允许为空，正确的姿势如下：

@PostMapping(value = "/hello2")
BetaDto hello2(@RequestParam("name1") String name1);

第三种情况，如下：

@PostMapping(value = "/hello2")
BetaDto hello2(String name1, String name2);

接口存在多个 key/value 参数，此时通过 Feign 调用该接口的调用方启动的时候会抛出如下错误：

Caused by: java.lang.IllegalStateException: Method has too many Body parameters

像这种多参数（key/value）的情况必须为每个参数增加 @RequestParam 注解，正确的姿势如下：

@PostMapping(value = "/hello2")
BetaDto hello2(@RequestParam(“name1”)  String name1, @RequestParam(“name2”)  String name2);

总结

在使用 @RequestParam 注解的时候，value 值必须设置，如下：

@PostMapping(value = "/hello2")
BetaDto hello2(@RequestParam(“name1”)  String name1);

如果接口有且只有一个参数，并且该参数是 key/value 类型，则无需为该参数设置 @RequestParam 注解，如下：

@PostMapping(value = "/hello2")
BetaDto hello2(String name1);

接口存在多个参数（key/value、Json 对象）的时候，每个 key/value 类型的参数必须显示的指定 @RequestParam 注解，且必须设置对应的 value

@PostMapping(value = "/hello2")
BetaDto hello2(@RequestParam(“name1”) String name1, RequestParam(“name2”) String name2, BetaDto betaDto);

接口无论有多个参数还是一个参数，都不需要为 Json 对象参数显示的指定 @RequestBody 注解

@PostMapping(value = "/hello1")
BetaDto hello1(BetaDto betaDto);

@PostMapping(value = "/hello2")
BetaDto hello2(@RequestParam(“name1”) String name1, RequestParam(“name2”) String name2, BetaDto betaDto);

每个接口里只允许有一个 JSON 对象类型的参数，否则通过 Feign 调用该接口的调用方启动的时候会抛出如下错误：

Caused by: java.lang.IllegalStateException: Method has too many Body parameters

上面摘自: Feign 中使用 @RequestParam、@RequestBody 的正确姿势_IT技术分享网

个人总结:

开发还是按规范来,post 请求就用对象来接收,就不会有这种问题~~

package com.riskeys.anyi.manage.remote.channel;


import com.riskeys.anyi.manage.model.dto.product.ProductViewDto;
import com.riskeys.anyi.manage.model.dto.product.ProductViewEditDto;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestParam;

/**
 * @Title: 商品信息远程调用路由配置
 * @Author: ken
 * @Description:
 * @Date: 2023/7/5  13:17
 * @Param:
 * @return
 **/
@FeignClient(name = "biz-channel-2b2a", contextId = "product", path = "/channel/tbta/product")
public interface ProductViewRemoteService {

    /**
     * @return com.riskeys.common.base.model.Result
     * @Title: 保存产品展示信息
     * @Author: ken
     * @Description:
     * @Date: 2023/6/26  15:35
     * @Param: [productViewDto]
     **/
    @PostMapping(value = "/saveProductView")
    void saveProductView(@RequestBody ProductViewDto productViewDto);

    /**
     * @return com.riskeys.common.base.model.Result
     * @Title: 下架产品展示信息
     * @Author: ken
     * @Description:
     * @Date: 2023/6/26  15:35
     * @Param: [productId]
     **/
    @PostMapping(value = "/editProductView")
    void editProductView(@RequestBody ProductViewEditDto productViewEditDto);

    /**
     * @return com.riskeys.anyi.manage.model.dto.product.ProductViewDto
     * @Title: 查询产品展示信息
     * @Author: ken
     * @Description:
     * @Date: 2023/7/5  13:17
     * @Param: [productId]
     **/
    @GetMapping(value = "/queryProductView")
    ProductViewDto queryProductView(@RequestParam("productId") String productId);
}

/**
 * @Title: 下架产品扩展信息DTO
 * @Author: ken
 * @Description:
 * @Date: 2030/6/13  16:56
 **/
@Data
@ApiModel(description = "下架产品扩展信息DTO")
public class ProductViewEditDto implements Serializable {

    private static final long serialVersionUID = -5370338334580177847L;

    /**
     * 产品ID
     */
    private String productId;
}