Spring Boot实现动态端点转发：单Controller路由至对应微服务

核心思路 #

完全可以通过单个Controller方法接收所有请求，结合静态配置或数据库存储的路由规则，自动转发请求到对应微服务。核心是用通配符映射捕获所有请求，匹配路由规则后通过HTTP客户端（RestTemplate/WebClient）转发请求，同时保留原请求的方法、参数、头信息。

具体实现步骤 #

1. 定义路由配置模型 #

先统一路由规则的结构，不管从配置文件还是数据库读取，模型一致：

@Data
public class RouteConfig {
    // 前端请求的路径匹配规则，比如"/user/**"
    private String pathPattern;
    // 目标微服务的基础地址，比如"http://user-service:8080"
    private String targetServiceUrl;
    // 可选：允许的HTTP方法，默认支持所有
    private Set<String> allowedMethods = new HashSet<>(Arrays.asList("GET", "POST", "PUT", "DELETE"));
}

2. 加载路由配置 #

方式一：静态配置文件（application.yml）

在配置文件中预定义路由规则：

app:
  routes:
    - pathPattern: "/user/**"
      targetServiceUrl: "http://user-service:8080"
      allowedMethods: [GET, POST]
    - pathPattern: "/order/**"
      targetServiceUrl: "http://order-service:8080"

通过@ConfigurationProperties加载配置：

@Configuration
@ConfigurationProperties(prefix = "app")
public class RouteProperties {
    private List<RouteConfig> routes;
    // getter/setter
}

方式二：数据库存储

创建路由表，用JPA/MyBatis查询规则，建议加缓存避免重复查库：

@Repository
public interface RouteConfigRepository extends JpaRepository<RouteConfigEntity, Long> {
    List<RouteConfigEntity> findByPathPatternStartingWith(String pathPrefix);
}

// 缓存示例（Spring Cache）
@Cacheable(value = "routes", key = "#pathPrefix")
public List<RouteConfig> getMatchedRoutes(String pathPrefix) {
    return routeConfigRepository.findByPathPatternStartingWith(pathPrefix);
}

3. 实现统一转发Controller #

用@RequestMapping("/**")匹配所有请求，完成路由匹配与转发：

@RestController
@RequestMapping("/**")
public class UnifiedForwardController {

    private final RouteProperties routeProperties;
    private final RestTemplate restTemplate;
    private final AntPathMatcher pathMatcher;

    public UnifiedForwardController(RouteProperties routeProperties, RestTemplate restTemplate) {
        this.routeProperties = routeProperties;
        this.restTemplate = restTemplate;
        this.pathMatcher = new AntPathMatcher();
    }

    @RequestMapping(method = {RequestMethod.GET, RequestMethod.POST, RequestMethod.PUT, RequestMethod.DELETE})
    public ResponseEntity<Object> forwardRequest(HttpServletRequest request, 
                                                 @RequestBody(required = false) Object body) throws URISyntaxException {
        // 1. 获取当前请求的核心信息
        String requestPath = request.getRequestURI();
        String requestMethod = request.getMethod();

        // 2. 匹配对应的路由规则
        RouteConfig matchedRoute = routeProperties.getRoutes().stream()
                .filter(route -> pathMatcher.match(route.getPathPattern(), requestPath)
                        && route.getAllowedMethods().contains(requestMethod))
                .findFirst()
                .orElseThrow(() -> new ResponseStatusException(HttpStatus.NOT_FOUND, "无匹配路由：" + requestPath));

        // 3. 构造目标服务的完整URL
        String targetPath = pathMatcher.extractPathWithinPattern(matchedRoute.getPathPattern(), requestPath);
        URI targetUri = new URI(matchedRoute.getTargetServiceUrl() + "/" + targetPath);

        // 4. 复制原请求头
        HttpHeaders headers = new HttpHeaders();
        Enumeration<String> headerNames = request.getHeaderNames();
        while (headerNames.hasMoreElements()) {
            String headerName = headerNames.nextElement();
            headers.set(headerName, request.getHeader(headerName));
        }

        // 5. 执行转发并返回响应
        HttpEntity<Object> requestEntity = new HttpEntity<>(body, headers);
        return restTemplate.exchange(targetUri, HttpMethod.valueOf(requestMethod), requestEntity, Object.class);
    }
}

4. 优化建议 #

• 异常处理：自定义全局异常处理器，处理路由匹配失败、服务不可达等场景，返回标准化错误响应。
• 前置校验：在转发逻辑前加入你的基础校验（如Token验证、参数合法性检查），直接在Controller方法中添加即可。
• 动态路由更新：若用数据库存储路由，可通过定时任务或消息通知刷新内存中的路由规则，无需重启服务。
• 性能优化：将路由规则缓存到本地（如Guava Cache），减少每次请求的匹配耗时。

替代方案：Spring Cloud Gateway #

如果你的架构已接入Spring Cloud生态，直接用Spring Cloud Gateway更高效。它是专门的API网关组件，支持静态/动态路由配置，自带限流、熔断、安全校验等功能，无需手动编写转发逻辑：

spring:
  cloud:
    gateway:
      routes:
        - id: user-service-route
          uri: lb://user-service
          predicates:
            - Path=/user/**
          filters:
            - StripPrefix=1 # 去掉/user前缀后转发
        - id: order-service-route
          uri: lb://order-service
          predicates:
            - Path=/order/**

内容的提问来源于stack exchange，提问作者Mukul Bindal