Spring Cloud Gateway无法定位微服务，报404路径未找到问题求助

问题描述 #

用Spring Boot搭建了3个微服务和1个API网关，配置网关后访问出现404: Path not found错误。已确认微服务正常运行并注册到Eureka Server，试过修改服务名称大小写、重启Discovery Client、查阅Stack Overflow均未解决。

网关pom.xml配置 #

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.2.2</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.hunterx</groupId>
    <artifactId>api-gateway</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>api-gateway</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>17</java.version>
        <spring-cloud.version>2023.0.0</spring-cloud.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
                        <artifactId>spring-cloud-starter-gateway-mvc</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </dependency>
    </dependencies>
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

网关application.properties配置 #

eureka.client.service-url.defaultZone=http://localhost:8761/eureka/
eureka.instance.hostname=localhost
spring.application.name=api-gateway

spring.cloud.gateway.discovery.locator.enabled=true
spring.cloud.gateway.discovery.locator.lower-case-service-id=true

logging.level=INFO
logging.level.org.springframework.cloud.gateway.route.RouteDefinitionLocator = INFO
logging.level.org.springframework.cloud.gateway=TRACE

#Product Service Route
spring.cloud.gateway.routes[0].id=product-service
spring.cloud.gateway.routes[0].uri=lb://product-service
spring.cloud.gateway.routes[0].predicates[0]=Path=/api/product

#Order Service Route
spring.cloud.gateway.routes[1].id=order-service
spring.cloud.gateway.routes[1].uri=lb://order-service
spring.cloud.gateway.routes[1].predicates[0]=Path=/api/order

排查与解决步骤 #

• 修正网关依赖：当前使用的spring-cloud-starter-gateway-mvc是MVC适配版本，若项目未明确依赖Spring MVC，建议替换为默认的WebFlux版本spring-cloud-starter-gateway，避免依赖冲突导致路由失效。
• 调整路径匹配规则：现有Path=/api/product仅匹配完全等于该路径的请求，无法覆盖子路径（如/api/product/list），需修改为带通配符的规则：

  spring.cloud.gateway.routes[0].predicates[0]=Path=/api/product/**
  spring.cloud.gateway.routes[1].predicates[0]=Path=/api/order/**
  

• 添加路径重写（若需）：如果微服务自身接口路径不含/api前缀，需通过过滤器重写路径，将网关的/api/product/**转发到微服务的/product/**：

  spring.cloud.gateway.routes[0].filters[0]=RewritePath=/api/product/(?<segment>.*), /product/${segment}
  spring.cloud.gateway.routes[1].filters[0]=RewritePath=/api/order/(?<segment>.*), /order/${segment}
  

• 校验Eureka服务ID：检查Eureka控制台（http://localhost:8761）中注册的服务ID是否与网关配置的lb://product-service完全一致（已开启小写转换，需确保微服务注册的ID为小写）。
• 分析路由日志：利用已开启的TRACE级日志，查看org.springframework.cloud.gateway输出，确认路由是否正确加载，以及请求进来时的匹配情况，定位是否存在路由未生效的问题。
• 直接测试微服务：跳过网关，直接访问微服务接口（如http://localhost:xxxx/api/product），确认接口本身可正常响应，排除微服务自身故障。

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