如何使用 Volley 将 JSONArray 安全发送到 PHP 服务器-php教程-PHP中文网

如何使用 Volley 将 JSONArray 安全发送到 PHP 服务器

本文详解 android 中通过 volley 向 php 后端提交 jsonarray 的正确方式，指出直接使用 jsonarrayrequest 的常见误区，并提供基于 stringrequest 的可靠解决方案，包含完整代码、php 接收逻辑及关键注意事项。

本文详解 android 中通过 volley 向 php 后端提交 jsonarray 的正确方式，指出直接使用 jsonarrayrequest 的常见误区，并提供基于 stringrequest 的可靠解决方案，包含完整代码、php 接收逻辑及关键注意事项。

在 Android 开发中，使用 Volley 发送 JSON 数据是常见需求，但许多开发者误以为 JsonArrayRequest 能直接以 POST 方式将 JSONArray 作为请求体（body）发送并被 PHP 正确解析——实际上，JsonArrayRequest 默认仅支持 GET 请求的响应解析，其 POST 构造器虽允许传入 JSONArray，但 Volley 并不会自动将其序列化为标准 application/json 请求体，且 PHP 的 $_POST 无法直接读取原始 JSON body。这正是导致服务端收到空数组的根本原因。

✅ 正确做法是：将 JSONArray 序列化为字符串，再通过 StringRequest 以表单参数（application/x-www-form-urlencoded）方式提交。以下是优化后的完整实现：

public void sendData(JSONArray data) {
    RequestQueue queue = Volley.newRequestQueue(this);
    String url = "http://10.123.20.180:8080/insertmatrix.php";

    String jsonPayload = data.toString(); // ✅ 序列化为标准 JSON 字符串

    StringRequest dataReq = new StringRequest(
        Request.Method.POST,
        url,
        response -> Toast.makeText(MainActivity.this, "Success", Toast.LENGTH_LONG).show(),
        error -> Toast.makeText(MainActivity.this, "Error: " + error.getMessage(), Toast.LENGTH_LONG).show()
    ) {
        @Override
        protected Map<string string> getParams() {
            Map<string string> params = new HashMap();
            params.put("data", jsonPayload); // ✅ 以键值对形式提交
            return params;
        }

        // ⚠️ 可选：显式设置 Content-Type（Volley 默认已设为 form-urlencoded）
        @Override
        public Map<string string> getHeaders() {
            Map<string string> headers = new HashMap();
            headers.put("Accept", "application/json");
            return headers;
        }
    };

    queue.add(dataReq);
}</string></string></string></string>

? PHP 端接收与解析示例（insertmatrix.php）：

Feishu calendar sync, local ics to json data for AI agent

将ICS日历文件转为JSON格式，用于飞书日历导入导出及数据集成。

下载

<?php header('Content-Type: application/json; charset=utf-8');

if (isset($_POST['data'])) {
    $jsonString = $_POST['data'];
    $jsonData = json_decode($jsonString, true);

    if (json_last_error() === JSON_ERROR_NONE && is_array($jsonData)) {
        // ✅ 成功解析 JSONArray
        foreach ($jsonData as $row) {
            // 示例：插入数据库（请务必使用 PDO/MySQLi 预处理防止 SQL 注入）
            $columnID = $row['columnID'] ?? null;
            $rowID = $row['rowID'] ?? null;
            $value = $row['value'] ?? null;
            // ... 执行 INSERT 逻辑
        }
        echo json_encode(['status' => 'success', 'count' => count($jsonData)]);
    } else {
        http_response_code(400);
        echo json_encode(['error' => 'Invalid JSON format']);
    }
} else {
    http_response_code(400);
    echo json_encode(['error' => 'Missing "data" parameter']);
}
?>

? 关键注意事项：

不要依赖 JsonArrayRequest 发送 POST 数据：它设计初衷是解析响应 JSON，而非构造 JSON 请求体；
始终校验 JSON 解析结果：PHP 端必须检查 json_last_error()，避免静默失败；
安全第一：从 $_POST 获取的数据仍需严格过滤与预处理（如使用 PDO 参数化查询），不可直接拼接 SQL；
网络调试建议：使用 Chrome DevTools 或 Postman 模拟相同 POST 表单请求，确认 PHP 接口行为一致；
大数组优化：若数据量极大（>1MB），考虑分片上传或改用 JsonObjectRequest 封装为 { "payload": [...] } 结构，更利于前后端契约管理。