Kotlin向PHP服务器发送JSON对象却接收null的问题求助

安全阿岳

2026-7-1

Kotlin Retrofit 发送JSON到PHP返回null的解决方法

问题根源

Retrofit请求体序列化异常：你使用org.json.JSONObject作为@Body参数，但GsonConverterFactory无法正确序列化该类，导致实际发送的JSON格式不符合预期，PHP端无法解析出有效数据。
返回字段映射不匹配：从日志可见，TestInfo定义的字段（如issueLine）与实际返回的JSON键名（如lineNumber）不一致，Gson无法自动完成字段映射，最终导致实体类所有字段为null。

解决步骤

1. 改用实体类作为请求体

直接使用TestInfo对象替代手动构建的JSONObject，Gson会自动完成正确的JSON序列化：

修改请求代码：

// 直接创建TestInfo实例，无需手动拼接JSON
val testInfo = TestInfo(
    issueLine = "123",
    issueActivity = "Main",
    issueFragment = "map",
    issueExplanation = "---"
)

val call = apiService.test(testInfo)

同步修改ApiService的方法参数类型：

interface ApiService {
    @POST("hamrahenet/test.php")
    fun test(@Body body: TestInfo): Call<TestInfo>
}

2. 确保字段映射一致

如果存在代码混淆或字段名差异，给TestInfo字段添加@SerializedName注解明确映射关系：

import com.google.gson.annotations.SerializedName

data class TestInfo(
    @SerializedName("issueLine")
    val issueLine: String,
    @SerializedName("issueActivity")
    val issueActivity: String,
    @SerializedName("issueFragment")
    val issueFragment: String,
    @SerializedName("issueExplanation")
    val issueExplanation: String
)

若开启了代码混淆，需在ProGuard规则中保留TestInfo类：

-keep class 你的包名.TestInfo { *; }

3. 验证PHP端接收状态

在PHP代码中添加日志，确认是否接收到正确的JSON数据：

<?php
$json = file_get_contents("php://input");
// 写入日志查看接收内容
file_put_contents('received_json.log', $json . PHP_EOL, FILE_APPEND);
$array = json_decode($json, true);
echo json_encode($array);