spring-cloud-gateway

Spring Cloud Gateway

让网关保持为边缘适配器。不要将领域工作流移入过滤器。

优先考虑兼容性

• 选择与确切的 Boot 3 次要版本兼容的 Spring Cloud 发布列车。
• 导入 Spring Cloud BOM，并省略各个 Spring Cloud 依赖的版本。
• 除非项目有意使用 MVC 变体，否则优先选择响应式网关。

路由规则

• 使用稳定的路由 ID 和明确的谓词。
• 在边缘移除不可信的转发、身份和内部标头。
• 先移除客户端提供的值，再添加关联标头。
• 在路由配置中明确展示路径重写和主机变更。
• 全局设置连接和响应超时，并仅为少数路由设置覆盖值。

安全与弹性

• 在边缘进行身份验证，并在下游服务中再次进行授权。
• 仅向预期受众转发令牌。
• 根据可信身份或 API 密钥进行限流，不要依赖未经验证的标头。
• 仅对幂等操作进行重试，并且仅在响应提交之前重试。
• 对故障依赖使用断路器；切勿用无限重试掩盖持续故障。

测试与运维

• 测试谓词、过滤器、标头移除、状态映射和超时。
• 使用 WireMock 或容器化上游进行集成测试。
• 输出路由 ID、结果、延迟和上游指标，并使用有限的标签。

示例

• 请参阅 examples/good-routes.yml 和 examples/bad-routes.yml。

常见问题

• Agent 信任来自公开请求的 X-User-Id——应在身份验证后推导身份。
• Agent 默认重试 POST 请求——仅重试已证实为幂等的操作。
• Agent 在网关过滤器中添加业务编排——将领域逻辑保留在下游。
• Agent 未设置响应超时——上游停滞可能耗尽网关资源。
• Agent 混用不兼容的 Spring Cloud 和 Boot 版本——请使用官方兼容性矩阵。