API 网关配置评审工作流

概述

网关配置长期只增不减会积累无用路由与不一致的保护，甚至出现绕过认证的路径。盘点路由并移除无流量者、核对网关与后端的认证分工、显式设置超时与限流、并实际测试受保护路由确被拦截，可让边界可信。

关键步骤

1. 盘点路由并移除无流量或无人负责者。
2. 对比网关与后端的认证与授权。
3. 有意设置超时、重试与限流。
4. 测试受保护请求确在网关被拦截。

验证

• 无用路由已移除。
• 未认证请求访问受保护路由在网关被拒。
• 认证以后端为权威。
• 例外有负责人记录。

决策点

认证以后端为权威，网关可叠加但不应是唯一检查；路由应默认拒绝并显式声明，默认允许会让新服务暴露到公网。

适用范围

本条目围绕「API 网关配置评审工作流」给出可复制的步骤、验证方式与常见问题，适合需要按此流程落地的工程团队。执行时请结合自身上下文调整命令与阈值，并在变更前后留存证据，便于后续复核与回滚。

建议在正式环境落地前先在预发或隔离环境演练一遍，把关键观测指标与负责人一并记录，确保出现异常时能快速定位并恢复。

routes:
  - path: /api/orders
    upstream: orders
    auth: required
    timeout: 5s
    rateLimit: { requests: 50, period: 1s }