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