Spring cloud gateway 设置context-path服务路由404排查

### 解决 Spring Cloud Gateway 配置完成后访问报错 404 的方法 当遇到 Spring Cloud Gateway 访问接口返回 404 错误的情况时，通常是因为路由配置不正确或者路径映射存在问题。以下是详细的排查和解决办法： #### 1. 检查 `servlet.context-path` 设置 如果项目中设置了 `server.servlet.context-path` 属性，则实际的 API 请求路径将会变为 `${context.path}/api`[^1]。因此，在定义网关路由时应考虑此上下文路径的影响。 #### 2. 确认路由 ID 对齐方式 确保在 `application.yml` 文件中的 `routes` 下面定义的每条路由前都有连字符 `-` 并且与其他项保持水平对齐。不对齐可能会引发诸如 503 这样的错误而不是 404，但这也是配置不当的表现之一[^3]。 ```yaml spring: application: name: getway-service cloud: gateway: routes: - id: pms-route # 注意这里的 '-' 符号要与 'routes' 对齐 uri: lb://pms-service predicates: - Path=/pms/** ``` #### 3. 处理多级断言规则顺序 对于具有不同层次结构的服务路由（例如 coupon_route 和 product_route），应该按照从高到低的优先级来排列这些路由。更具体的模式应当位于较早的位置以便先被匹配处理，从而避免因次序问题引起的 404 错误[^5]。 #### 4. 核实 URI 地址准确性 确认所使用的负载均衡器 (`lb`) 后端服务名称是否已在 Nacos 或其他注册中心成功注册并可用。此外还要验证目标微服务的实际 URL 是否拼写无误，并能通过直连方式进行正常通信测试。 #### 5. 排除跨域影响因素 虽然这不是直接引起 404 的原因，但如果存在 CORS (Cross-Origin Resource Sharing) 相关设置不合理的话也可能间接造成前端无法获取资源而显示为 404 页面。可以参照特定版本下的最佳实践调整相应的头信息和其他参数以支持跨源资源共享需求[^2]。 #### 6. 审视文件上传场景特殊性 如果是涉及到大文件传输或者其他复杂表单提交操作的情况下，请特别留意是否有额外的数据转换逻辑或中间件干扰到了原始 HTTP POST 请求体的内容完整性，进而导致接收方找不到预期的目标处理器函数[^4]。 综上所述，以上几点可以帮助定位并修复由 Spring Cloud Gateway 引起的 404 响应码异常状况。建议逐一审查上述方面直至找到确切的原因所在。