API使用最佳实践：控制器所有API路由都使用POST方法是否正确？

这种做法不符合通用API设计最佳实践中的请求方法选型规范。

通用请求方法选型核心规范 #

按照RESTful等主流API设计标准，不同请求方法有明确的语义分工：

• GET：用于查询读取资源，不修改服务端数据，具备幂等性，支持缓存、书签存储、浏览器直接访问
• POST：用于创建新资源，不具备幂等性，会修改服务端数据
• PUT：用于全量更新已有资源，具备幂等性
• DELETE：用于删除资源，具备幂等性
• PATCH：用于局部更新已有资源，通常不要求幂等

全量使用POST的核心问题 #

• 语义完全失效：开发者、网关、缓存中间件无法通过请求方法判断接口的作用和副作用，原本可自动生效的查询缓存、流量调度等能力都会失效，浪费服务性能
• 安全风险提升：读取类接口和修改类接口使用相同请求方法，会提升CSRF防护的复杂度，也更容易出现误调用导致的数据变更问题
• 维护成本上升：排查问题、对接接口时无法通过请求方法快速区分接口类型，接口的可读性和可维护性会大幅下降

仅在部分特殊场景下可以有限使用POST替代其他方法，比如需要规避GET请求的参数长度限制、老旧网关不支持PUT/DELETE等方法，但这属于特定场景下的妥协方案，不能作为全控制器所有路由的统一规则。

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