1. 问题现象:为什么我的Restful端点失效了?
最近在做一个Spring Boot项目时,我遇到了一个奇怪的问题。按照官方文档的说明,我用@Endpoint注解定义了一个自定义端点,希望通过Restful风格访问,比如/actuator/my-endpoint/abc。但实际运行时,这个路径总是返回404错误,只有通过查询参数的方式(/actuator/my-endpoint?name=abc)才能正常访问。
这个问题让我百思不得其解,因为我的代码看起来完全符合规范:
java复制@Component
@Endpoint(id = "my-endpoint")
public class MyEndpoint {
@ReadOperation
public String get(@Selector String name) {
return name;
}
}
按照Spring Boot Actuator的设计,@Selector注解应该能让这个端点支持路径参数。但实际运行时,路径参数完全不起作用,这显然不符合预期。更奇怪的是,内置的健康检查端点(比如/actuator/health/consul)却能完美支持路径参数。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 深入源码:寻找问题根源
为了找出问题原因,我决定深入Spring Boot的源码一探究竟。通过断点调试,我发现关键点在WebEndpointDiscoverer.createOperation()方法中。这个方法负责将我们定义的端点方法转换为可执行的操作。
在调试过程中,我注意到一个关键细节:对于我的自定义端点,方法参数名被识别为"arg0",而不是我定义的"name"。这就解释了为什么Restful路径失效 - Spring MVC无法将路径中的{name}匹配到arg0参数上。
继续追踪,发现参数名的获取是通过DiscoveredOperationMethod.getParameters()实现的,这个方法底层调用了JDK的Method.getParameters()。这里就是问题的关键所在:
java复制private Parameter[] synthesizeAllParams() {
final int realparams = ge
