Spring Boot中统一为PUT/DELETE接口添加POST方法支持
实现方案
在私有化部署场景中遇到WAF防护策略限制，需将原有RESTful接口的HTTP方法统一转换为POST请求。针对已有系统的改造需求，采用Spring框架底层机制实现接口方法的动态扩展。
通过继承RequestMappingHandlerMapping类，实现对特定包路径下的接口方法进行拦截处理。核心逻辑如下：
public class MethodEnhancementHandler extends RequestMappingHandlerMapping {
private static final String[] TARGET_PACKAGES = {"com.example.framework", "cn.example.framework"};
private static final Set<RequestMethod> TARGET_METHODS = Set.of(RequestMethod.PUT, RequestMethod.DELETE);
@Override
protected RequestMappingInfo getMappingForMethod(Method method, Class<?> handlerType) {
// 包路径过滤与注解校验
if (isTargetPackage(handlerType) && hasRequestMappingAnnotation(method)
&& !containsFeignClientAnnotation(handlerType)) {
RequestMappingInfo originalMapping = super.getMappingForMethod(method, handlerType);
// 方法匹配与POST方法注入
if (matchesTargetMethods(originalMapping)
&& !originalMapping.getMethodsCondition().getMethods().contains(RequestMethod.POST)) {
Set<RequestMethod> enhancedMethods = new HashSet<>(originalMapping.getMethodsCondition().getMethods());
enhancedMethods.add(RequestMethod.POST);
return createEnhancedMapping(originalMapping, enhancedMethods);
}
}
return super.getMappingForMethod(method, handlerType);
}
private boolean isTargetPackage(Class<?> handlerType) {
for (String packagePath : TARGET_PACKAGES) {
if (handlerType.getName().startsWith(packagePath)) {
return true;
}
}
return false;
}
private boolean hasRequestMappingAnnotation(Method method) {
return AnnotatedElementUtils.hasAnnotation(method, RequestMapping.class);
}
private boolean containsFeignClientAnnotation(Class<?> handlerType) {
return AnnotatedElementUtils.hasAnnotation(handlerType, FeignClient.class);
}
private boolean matchesTargetMethods(RequestMappingInfo mapping) {
return mapping.getMethodsCondition().getMethods().stream()
.anyMatch(TARGET_METHODS::contains);
}
private RequestMappingInfo createEnhancedMapping(RequestMappingInfo original, Set<RequestMethod> methods) {
return RequestMappingInfo.paths().build()
.combine(original)
.methodsCondition( MethodsConditionFactory.createCondition(methods));
}
}
配置类注册实现
@Configuration(proxyBeanMethods = false)
@ConditionalOnProperty(name = "api.method.enhancement.enabled", matchIfMissing = true)
public class WebConfig implements WebMvcRegistrations {
@Override
public RequestMappingHandlerMapping getRequestMappingHandlerMapping() {
MethodEnhancementHandler handler = new MethodEnhancementHandler();
handler.setOrder(Ordered.HIGHEST_PRECEDENCE);
return handler;
}
}
通过该方案，原有DELETE接口在Swagger中将同时展示POST方法支持，实现HTTP方法的兼容性增强。以下是接口定义对比示例：
