记Swagger的一次错误，接口为Get请求，Swagger接口却以body传入。

最新推荐文章于 2025-08-05 16:45:22 发布

原创最新推荐文章于 2025-08-05 16:45:22 发布 · 2.4k 阅读

1 ·

CC 4.0 BY-SA版权

问题记录专栏收录该内容

4 篇文章

订阅专栏

本文探讨了如何修正SpringBoot接口中GET请求的参数问题，通过修改@ApiImplicitParams的paramType，解决了将商品详情接口从GET改为POST的需求，并分享了调整后的Swagger接口展示。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

首先我们看看我的SpringBoot接口

@ApiOperation("商品详情")
    @ApiResponses(@ApiResponse(code = 200, message = "ok", response = GoodsDetailsVo.class))
    @GetMapping("detail")
    @ApiImplicitParams({
            @ApiImplicitParam(value = "用户id", name = "userId"),
            @ApiImplicitParam(value = "商品id", name = "id"),
    })
    public Object detail(@LoginUser Integer userId,
                         @NotNull Integer id) {
        // 商品信息
        LitemallGoods info = goodsService.findById(id);

        // 商品属性
        Callable<List> goodsAttributeListCallable = () -> goodsAttributeService.queryByGid(id);

        // 商品规格 返回的是定制的GoodsSpecificationVo
        Callable<Object> objectCallable = () -> goodsSpecificationService.getSpecificationVoList(id);

然后我们看看Swagger接口

在这里插入图片描述

百度了之后，都建议改get请求为post，这不能解决实质问题呀，我不可能所有请求都用post呀。

后来我发现是自己的参数设置请求类型确实有问题，paramType默认是body传入，所有我只需要修改为下面这样

@ApiOperation("商品详情")
    @ApiResponses(@ApiResponse(code = 200, message = "ok", response = GoodsDetailsVo.class))
    @GetMapping("detail")
    @ApiImplicitParams({
            @ApiImplicitParam(value = "用户id", name = "userId", paramType = "query"),
            @ApiImplicitParam(value = "商品id", name = "id", paramType = "query"),
    })
    public Object detail(@LoginUser Integer userId,
                         @NotNull Integer id) {
        // 商品信息
        LitemallGoods info = goodsService.findById(id);

        // 商品属性
        Callable<List> goodsAttributeListCallable = () -> goodsAttributeService.queryByGid(id);