Plaid Link Token 创建失败：JSON 解析错误的完整解决方案

本文详解 plaid api 创建 link token 时出现 “body could not be parsed as json” 错误的根本原因及修复方法，涵盖数据结构、序列化方式、请求头设

置等关键要点。

在使用 Plaid API 创建 Link Token 时，INVALID_BODY: body could not be parsed as JSON 是一个高频但易被忽视的错误。它并非表示 JSON 格式语法错误，而是服务端无法将请求体解析为合法的 JSON 对象——通常由两个核心问题导致：（1）PHP 数组未正确 JSON 序列化；（2）products 和 country_codes 等字段被传为字符串而非数组。

? 关键问题解析

• ❌ 错误做法：

  'products' => 'auth',        // 字符串 → Plaid 拒绝
  'country_codes' => 'US',    // 字符串 → Plaid 拒绝
  curl_setopt($ch, CURLOPT_POSTFIELDS, $data); // 直接传 PHP 数组 → cURL 自动 urlencode，非 JSON！

• ✅ 正确要求（依据 Plaid 官方文档）：

  • products 必须是 字符串数组，如 ["auth", "transactions"]
  • country_codes 必须是 字符串数组，如 ["US", "CA"]
  • 请求体必须是 标准 UTF-8 编码的 JSON 字符串（不是 URL-encoded 表单）
  • Content-Type 请求头必须为 application/json
  • CURLOPT_POSTFIELDS 必须接收 已 json_encode() 的字符串，而非原始数组

✅ 正确实现示例（PHP + cURL）

 $plaidID,
    'secret' => $plaidSecret,
    'client_name' => $clientName,
    'user' => [
        'client_user_id' => $userID
    ],
    'products' => ['auth'],           // ✅ 必须是数组
    'country_codes' => ['US'],        // ✅ 必须是数组
    'language' => 'en',
    'webhook' => 'https://webhook.sample.com'
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://{$apiMode}.plaid.com/link/token/create");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Accept: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); // ✅ 关键：必须 json_encode
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $result = json_decode($response, true);
    echo "Link token: " . $result['link_token'];
} else {
    echo "Error ({$httpCode}): " . $response;
}
?>

⚠️ 注意事项与最佳实践

• 不要使用 http_build_query() 处理请求体：它生成 key=value&... 格式，与 application/json 冲突；
• 避免强制转为 (object)：json_encode((object)$data) 并非必需，且可能引发意外键名处理（如数字索引转对象属性），直接 json_encode($data) 更安全、语义清晰；
• 验证 JSON 输出：调试时可先 echo json_encode($data); die(); 确认结构是否符合 Plaid Link Token Create Schema；
• 启用错误报告：在开发环境开启 error_reporting(E_ALL); ini_set('display_errors', 1); 快速定位 PHP 层异常；
• Postman 调试提示：若 Postman 同样报错，请确认 Body → raw → JSON 模式已选中，并粘贴格式正确的 JSON 字符串（非表单键值对）。

遵循以上规范后，INVALID_BODY 错误将彻底解决。Link Token 是 Plaid 集成的第一步，确保其稳定生成，是后续账户连接与数据同步的基础保障。