You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Spring Boot 3集成springdoc-openapi路径参数不显示问题求助

SpringDoc OpenAPI路径参数在Swagger UI不显示问题

我正在进行Spring Boot版本变更测试练习,创建了一个简单API并集成springdoc-openapi-starter-webmvc-ui用于接口测试。但/{id}接口的路径参数未在Swagger界面显示输入项,无法输入值。根据文档,仅需定义RestController类和Maven依赖即可测试,但实际并非如此。

控制器代码示例

@RestController
@RequestMapping("/customer")
public class CustomerRestController {
    
    @Autowired
    CustomerRepository customerRepository;
    
    @GetMapping()
    public List<Customer> customers() {
        return customerRepository.findAll();
    }
    
    @GetMapping("/{id}")
    public Customer get(@PathVariable Long id) {
        return customerRepository.findById(id).orElse(new Customer());
    }
    
}

我尝试了2.1.0、2.2.0和2.3.0版本,结果一致。

Maven依赖配置

<dependency>
    <groupId>org.springdoc</groupId>
    <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
    <version>2.1.0</version>
</dependency>

项目结构复杂,需先编译整个paymentchain-parent项目,再独立运行customer项目,访问http://localhost:8081/swagger.html查看结果。

内容的提问来源于stack exchange,提问作者Marco Osorio

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.01 19:02:36