RESTful API设计如何避免415?标准请求头规范?
415 Unsupported Media Type的预防措施:
- 客户端规范
- 必须设置
Content-Type(如application/json) - 多格式支持时用
Accept头协商(如*/*兜底)
- 必须设置
- 服务端容错
- 严格校验Content-Type与body实际格式
- 提供错误详情(如
{"error":"Require application/json"})
| 标准实践 | 示例头字段 | 框架支持 |
|---|---|---|
| 版本化API | Accept: application/vnd.api.v1+json |
Spring @RequestMapping |
| 表单/JSON兼容 | 检测Content-Type自动解析 |
FastAPI Body参数 |
| 错误响应标准化 | 统一错误码4150001 |
Swagger文档标注 |
| Preflighted请求 | OPTIONS预检支持的方法 | CORS中间件处理 |

更新时间:2025-06-20 18:01:24
