在 Android 开发中，Retrofit 是一款非常流行的网络请求库，它以其简洁优雅的 API 和强大的功能深受开发者喜爱。然而，在使用 Retrofit 进行 HTTP 请求时，有时会遇到一些令人头疼的问题，其中 `415 Unsupported Media Type` 错误便是其中之一。
什么是 415 错误？
当服务器无法处理客户端发送的内容类型时，就会返回 `415 Unsupported Media Type` 状态码。这通常意味着客户端发送的数据格式与服务器期望的格式不匹配。例如，服务器可能期望接收 JSON 数据，而客户端却发送了普通的表单数据。
常见原因分析
1. Content-Type 设置错误
Retrofit 默认会根据泛型参数自动设置 `Content-Type`，但如果手动设置了错误的 `Content-Type`，可能会导致服务器无法解析请求体。例如，如果服务器期望 `application/json`，但客户端却发送了 `text/plain`，就会触发该错误。
2. RequestBody 格式不正确
如果需要发送 JSON 数据，但未将 Java 对象正确序列化为 JSON 字符串，也会引发此问题。此外，如果发送的是表单数据（如 `application/x-www-form-urlencoded`），但未正确配置 `@FormUrlEncoded` 注解，也可能导致服务器无法识别。
3. API 文档理解有误
每个接口对输入参数和请求头的要求可能不同。如果未仔细阅读 API 文档，可能会遗漏某些关键配置，比如是否需要添加额外的头部信息或特定的编码方式。
解决方案
以下是一些常见的排查与修复方法：
1. 检查 Content-Type 设置
确保 Retrofit 的请求体与服务器预期一致。可以通过以下方式显式设置 `Content-Type`：
```java
@Headers("Content-Type: application/json")
@POST("your-endpoint")
Call
```
或者动态设置：
```java
RequestBody requestBody = RequestBody.create(MediaType.parse("application/json"), json.toString());
```
2. 确保数据格式正确
如果需要发送 JSON 数据，请使用 `GsonConverterFactory` 将对象转换为 JSON 字符串：
```java
Retrofit retrofit = new Retrofit.Builder()
.baseUrl("https://example.com/")
.addConverterFactory(GsonConverterFactory.create())
.build();
```
3. 验证表单数据格式
如果接口需要表单数据，记得添加 `@FormUrlEncoded` 注解，并逐字段标注 `@Field`：
```java
@FormUrlEncoded
@POST("your-endpoint")
Call
@Field("username") String username,
@Field("password") String password
);
```
4. 调试日志输出
在开发阶段，开启 Retrofit 日志记录功能可以帮助快速定位问题。通过拦截器打印完整的请求和响应
```java
OkHttpClient client = new OkHttpClient.Builder()
.addInterceptor(new HttpLoggingInterceptor().setLevel(HttpLoggingInterceptor.Level.BODY))
.build();
Retrofit retrofit = new Retrofit.Builder()
.client(client)
.baseUrl("https://example.com/")
.addConverterFactory(GsonConverterFactory.create())
.build();
```
总结
`415 Unsupported Media Type` 错误虽然看似简单，但实际上涉及多个方面的细节。无论是 Content-Type 的设置、数据格式的处理，还是对 API 文档的理解，都需要开发者认真对待。希望本文能帮助大家快速定位并解决问题，让 Retrofit 的使用更加得心应手！
