解决使用PHP cURL POST JSON API时出现500错误-php教程-PHP中文网

解决使用PHP cURL POST JSON API时出现500错误

花韻仙語

发布： 2025-09-11 16:19:01

原创

637人浏览过

解决使用php curl post json api时出现500错误

本文旨在帮助开发者解决在使用PHP cURL向API发送JSON数据时遇到的500 Internal Server Error。通过分析错误信息和检查JSON格式，重点排查API期望数组但实际接收到对象的情况，提供了一种有效的调试思路和解决方案。

在使用PHP cURL与API交互时，经常会遇到需要发送JSON数据的场景。然而，不正确的JSON格式或API端对数据格式的严格要求，可能导致服务器返回500 Internal Server Error。本文将通过一个实际案例，分析错误原因并提供解决方案。

分析错误信息

当API返回500错误时，通常会在响应中包含更详细的错误信息。例如，在提供的案例中，错误信息为：

立即学习“PHP免费学习笔记（深入）”；

{
  "errors": [
    {
      "status": "500 Internal Server Error",
      "code": "JA006",
      "detail": "Erro de sistema JA006: erro interno na base de dados. Por favor contacte o suporte técnico.",
      "meta": {
        "internal-error": "in JsonapiJson::Value::operator[](ArrayIndex)const: requires arrayValue"
      }
    }
  ],
  "jsonapi": {
    "version": "1.0",
    "meta": {
      "libversion": "2.4.1"
    }
  }
}

登录后复制

关键信息在于 internal-error: "in JsonapiJson::Value::operator[](ArrayIndex)const: requires arrayValue"。这表明服务器端的代码在尝试使用数组索引访问JSON中的某个值时失败，因为该值实际上是一个对象，而不是一个数组。

检查JSON格式

根据错误信息，我们需要仔细检查发送的JSON数据，确认是否存在API期望数组但实际发送了对象的情况。在提供的案例中，可以重点关注 data、relationships 和 addresses 字段。

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

查看详情

原始JSON数据如下：

{
  "data": {
    "type": "customers",
    "attributes": {
      "tax_registration_number": "5555555550",
      "business_name": "Test customer",
      "contact_name": "Mr. Test",
      "website": "https://www.testurl.pt",
      "phone_number": "2299999999",
      "mobile_number": "9299999999",
      "email": "<a class=\"__cf_email__\" data-cfemail=\"3f4b5a4c4b7f4b5a4c4b5c4a4c4b50525a4d114f4b\" href=\"/cdn-cgi/l/email-protection\">[email protected]</a>",
      "observations": "This is only a test",
      "internal_observations": "This is good customer",
      "not_final_customer": null,
      "cashed_vat": null,
      "tax_country_region": "PT-MA"
    },
    "relationships": {
      "main_address": {
        "data": {
          "type": "addresses",
          "id": 1
        }
      },
      "addresses": {
        "data": [
          {
            "type": "addresses",
            "id": 1
          },
          {
            "type": "addresses",
            "id": 2
          }
        ]
      }
    }
  }
}

登录后复制

一种可能的错误是 addresses 字段。如果API期望 addresses 是一个数组，而当前它是一个包含 data 字段的对象，那么就会触发 requires arrayValue 错误。

解决方案

根据分析，修改JSON格式，将 addresses 字段直接定义为数组，移除中间的 data 对象：

{
  "data": {
    "type": "customers",
    "attributes": {
      "tax_registration_number": "5555555550",
      "business_name": "Test customer",
      "contact_name": "Mr. Test",
      "website": "https://www.testurl.pt",
      "phone_number": "2299999999",
      "mobile_number": "9299999999",
      "email": "email@example.com",
      "observations": "This is only a test",
      "internal_observations": "This is good customer",
      "not_final_customer": null,
      "cashed_vat": null,
      "tax_country_region": "PT-MA"
    },
    "relationships": {
      "main_address": {
        "data": {
          "type": "addresses",
          "id": 1
        }
      },
      "addresses": [
        {
          "type": "addresses",
          "id": 1
        },
        {
          "type": "addresses",
          "id": 2
        }
      ]
    }
  }
}

登录后复制

修改PHP cURL代码，确保发送的是修正后的JSON数据。

$json = '{
  "data": {
    "type": "customers",
    "attributes": {
      "tax_registration_number": "5555555550",
      "business_name": "Test customer",
      "contact_name": "Mr. Test",
      "website": "https://www.testurl.pt",
      "phone_number": "2299999999",
      "mobile_number": "9299999999",
      "email": "email@example.com",
      "observations": "This is only a test",
      "internal_observations": "This is good customer",
      "not_final_customer": null,
      "cashed_vat": null,
      "tax_country_region": "PT-MA"
    },
    "relationships": {
      "main_address": {
        "data": {
          "type": "addresses",
          "id": 1
        }
      },
      "addresses": [
        {
          "type": "addresses",
          "id": 1
        },
        {
          "type": "addresses",
          "id": 2
        }
      ]
    }
  }
}';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/vnd.api+json',
    'Accept: application/json',
    'Authorization: Bearer ' . $token,
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
var_dump($response);
$response = json_decode($response, true);
curl_close($ch);

登录后复制

注意事项和总结