Spring Zuul路由配置异常：URL映射至serviceId而非配置的route path

这问题我之前踩过坑！看你的描述，自定义的/rest/**路由没生效，反而默认的服务名路由/service-rest/**能正常工作，大概率是YAML配置的缩进错误导致自定义路由规则没被Zuul加载。

第一步：检查YAML配置的缩进 #

YAML对缩进要求非常严格，你的配置可能因为缩进不正确，导致rest这个路由节点没有被正确识别为zuul.routes的子节点。正确的配置格式应该是这样的：

zuul:
  routes:
    rest:
      path: /rest/**
      serviceId: service-rest

注意：routes下面的rest要缩进2个空格，path和serviceId又要在rest下面再缩进2个空格（只要保持子节点比父节点缩进一致即可）。如果缩进不对，Zuul会忽略这个自定义路由，只启用默认的服务名路由规则。

第二步：验证路由配置是否加载 #

你可以在Zuul服务里添加Spring Boot Actuator依赖，开启路由端点来查看当前加载的规则：

1. 先添加Actuator依赖（以Maven为例）：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

2. 在配置文件中开启路由端点：

management:
  endpoints:
    web:
      exposure:
        include: routes

3. 访问http://localhost:5555/actuator/routes，如果能看到/rest/** -> service-rest这条路由，说明配置加载成功；如果看不到，那肯定是配置格式的问题。

其他可能的排查点 #

• 确认Zuul服务类上添加了@EnableZuulProxy注解：虽然默认路由能工作，但完整的自定义路由功能需要这个注解来启用。
• 检查REST服务的上下文路径：如果你的REST服务设置了server.servlet.context-path（比如/api），那Zuul转发后的路径会和预期不符。这种情况可以调整Zuul的stripPrefix配置，比如：

zuul:
  routes:
    rest:
      path: /rest/**
      serviceId: service-rest
      stripPrefix: false # 保留/rest前缀，适配REST服务的上下文路径

• 排查路由规则冲突：如果有其他自定义路由的path和/rest/**重叠，可能会导致优先级覆盖问题。

测试验证 #

修改配置后重启Zuul服务，再执行：

curl -i http://localhost:5555/rest/hello

应该就能正常返回200了。

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