本文详解 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 官方文档）：
✅ 正确实现示例（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 集成的第一步，确保其稳定生成，是后续账户连接与数据同步的基础保障。
