博客
关于我
报错:Required String paramenter "开始时间"
阅读量:618 次
发布时间:2019-03-13

本文共 1699 字,大约阅读时间需要 5 分钟。

《 Swagger参数注入优化笔记》

最近在尝试使用 Swagger 2.x 的时候遇到了一个关于参数注入的问题,导致程序报错,感觉有点难下手。今天想一下怎么解决这个问题,记录下来方便以后查阅。

问题描述:

当在某个 controller 方法头注入 String 参数 "开始时间" 的时候,系统报错提示 Required String parameter "开始时间",提示无法找到正确的注入参数。虽然看起来和 Swagger 参数映射相关,但仔细检查发现问题其实在参数名称的命名不统一。

开发环境配置:

spring-bootVersion=2.1.4Lucene version: 8.11.6δίwa{xIJlqXStY"(把实际应用的版本和依赖库打印出来更清晰/Application.Controllers*Controller.java)// 其他配置...

####问题原因:Spring Boot 无法识别正确的注入源,原因在于:

  • @ApiParam@RequestParam 的命名不统一。

    • @ApiParam默认映射的是يبądutyProfile 参数 namespacing。

    • @RequestParam直接解析请求参数名。

    • 比如,如果 controller 中使用 @ApiParam(name = "startTime")@RequestParam(value = "开始时间"),但 Spring 只能识别其一,导致参数无法正确注入。

####解决方法:

  • 参数命名统一:确保controller 方法中的 @ApiParam@RequestParam 的 name 填写一致。

    比如,无论是使用 startTime 还是 开始时间,方法内部参数命名都应选择一个(如 startTime)。

  • 使用默认映射:如果需要灵活映射,可以在 controller 方法中使用 @RequestBody@RequestParam:

    @PostMapping("/api/test")public ResponseEntity test(    @ApiParam("startTime") String startTime,    @RequestBody Map
    requestBody) { // 处理逻辑}
  • 注意 Swagger文档优化:

    • 确保 API 端点在 Swagger 文档中正确显示:
      paths:  /api/test:    post:      description: 测试端点      requestBody:        required: true        content:          application/json:            schema:              $ref: '#/components/schemas/Request'
    • 检查 Swagger UI 是否正确显示参数和请求体。
  • ####实际修复示例:假设修改后的 controller 方法头为:

    @ApiParam(name = "startTime")String startTime,@RequestParam(name = "开始时间")String requestBody,

    结果验证:

    • Swagger UI 中可以看到正确映射的参数名称。
    • 调用测试 API 后,能在 console 中看到 startTimerequestBody 正确传输.
    • 无报错提示,程序正常运行.

    总结:

    参数命名不规范会导致Spring Boot 异常处理机制出现问题,建议开发者在 Swagger 2.x 开发过程中统一参数命名,避免混淆。在遇到实际问题时,及时通过IDE反馈调试,确保 controller 中的 @ApiParam@RequestParam 的名称配合正确。这样不仅节省调试时间,也有助于 API 文档的规范化。

    原文:2019-07-15 Mr.chenyb

    转载地址:http://jiyaz.baihongyu.com/

    你可能感兴趣的文章
    mysql中json_extract的使用方法
    查看>>
    mysql中json_extract的使用方法
    查看>>
    mysql中kill掉所有锁表的进程
    查看>>
    mysql中like % %模糊查询
    查看>>
    MySql中mvcc学习记录
    查看>>
    mysql中null和空字符串的区别与问题!
    查看>>
    MySQL中ON DUPLICATE KEY UPDATE的介绍与使用、批量更新、存在即更新不存在则插入
    查看>>
    MYSQL中TINYINT的取值范围
    查看>>
    MySQL中UPDATE语句的神奇技巧,让你操作数据库如虎添翼!
    查看>>
    Mysql中varchar类型数字排序不对踩坑记录
    查看>>
    MySQL中一条SQL语句到底是如何执行的呢?
    查看>>
    MySQL中你必须知道的10件事,1.5万字!
    查看>>
    MySQL中使用IN()查询到底走不走索引?
    查看>>
    Mysql中使用存储过程插入decimal和时间数据递增的模拟数据
    查看>>
    MySql中关于geometry类型的数据_空的时候如何插入处理_需用null_空字符串插入会报错_Cannot get geometry object from dat---MySql工作笔记003
    查看>>
    mysql中出现Incorrect DECIMAL value: '0' for column '' at row -1错误解决方案
    查看>>
    mysql中出现Unit mysql.service could not be found 的解决方法
    查看>>
    mysql中出现update-alternatives: 错误: 候选项路径 /etc/mysql/mysql.cnf 不存在 dpkg: 处理软件包 mysql-server-8.0的解决方法(全)
    查看>>
    Mysql中各类锁的机制图文详细解析(全)
    查看>>
    MySQL中地理位置数据扩展geometry的使用心得
    查看>>