json_decode(): Argument #1 ($json) must be of type string, int given: what it means and how to fix it

TL;DR: Validate locally, fix the first real error, validate again (no upload).

Troubleshoot json_decode(): Argument #1 ($json) must be of type string, int given quickly and validate JSON locally (no upload).

Guides by runtime PHP guides

What the error means

json_decode(): Argument #1 ($json) must be of type string, int given means the parser expected valid JSON but encountered a character/token that cannot appear there. In practice, it usually means the input is not JSON (or not strict JSON), or it is incomplete.

Most common real-world causes

  • The input is not strict JSON (single quotes, comments, trailing commas).
  • The response is truncated (missing closing } / ] / ").
  • The response contains a prefix/suffix (logs, banners, debug output).
  • The payload has invalid escapes or control characters in strings.
  • You are parsing the wrong thing (already-parsed object, HTML, CSV, etc).

Fast debugging steps

  • Validate the JSON as-is to get an exact error location.
  • Check the first and last 50 characters for truncation and prefixes.
  • Fix one issue at a time and re-validate after each change.

Code example (php)

$obj = json_decode($text, true);
if (json_last_error() !== JSON_ERROR_NONE) {
  throw new Exception(json_last_error_msg());
}

Fix without uploading data

If the JSON contains sensitive data, validate and fix it locally. No Upload Tools runs 100% in your browser.

Workflow: validate -> fix the first error -> validate again -> export/convert.

FAQ

Does the exact token matter? Yes. The token often hints at the root cause: < is usually HTML, u is often undefined, and / often points to comments.

Should I just regex-fix JSON? Avoid blind regex edits. Validate after each change so you know what you fixed and what broke.

Next steps
Related by intent
json_decode() expects parameter 1 to be string, int given: what it means and how to fix it json_decode(): Argument #1 ($json) must be of type string, object given: what it means and how t json_decode(): Argument #1 ($json) must be of type string, null given: what it means and how to json_decode(): Argument #1 ($json) must be of type string, float given: what it means and how to json_decode(): Argument #1 ($json) must be of type string, bool given: what it means and how to
Privacy & Security
All processing happens locally in your browser. Files are never uploaded.

Related by intent

Useful follow-up pages selected from real search impressions and no-click opportunities.

No-click fix: php json decode arg1 string array givenNo-click fix: php json decode arg1 string float givenNo-click fix: php json decode expects string bool givenRelated fix: neighbor go go json cannot unmarshal string into field meta count type int runbooks webhooksRelated fix: neighbor go go json cannot unmarshal string into field meta count type int checklists webhooRelated fix: neighbor go go json cannot unmarshal string into field meta count type int runbooks api gateRelated fix: neighbor go go json cannot unmarshal string into field meta count type int runbooks data impRelated fix: neighbor go go json cannot unmarshal string into field meta count type int checklists api ga

Похожие материалы

Next pages to check

Closest crawled pages without impressions yet. Added to speed first-impression conversion.

neighbor csharp php json decode arg1 string int given workflows data importneighbor csharp php json decode arg1 string array given workflows data importneighbor csharp php json decode arg1 string float given workflows data importneighbor csharp php json decode expects string array given workflows data importneighbor csharp php json decode expects string array given workflows enterprise rolloutneighbor csharp php json decode expects string null given workflows data importneighbor php go json cannot unmarshal string into field item price type int troubleshootneighbor php go json cannot unmarshal string into field meta count type int troubleshootneighbor php go json cannot unmarshal string into field payload items type int troubleshneighbor php go json cannot unmarshal string into field user email type int troubleshootneighbor go go json cannot unmarshal string into field meta count type int checklists apneighbor go go json cannot unmarshal string into field meta count type int troubleshootineighbor csharp php json decode state mismatch invalid or malformed json workflows enterneighbor php go json cannot unmarshal array into field payload items type int troubleshoneighbor php go json cannot unmarshal array into field payload user type string troublesneighbor php go json cannot unmarshal array into field user id type string troubleshootineighbor php go json cannot unmarshal bool into field meta count type int troubleshootinneighbor php go json cannot unmarshal bool into field payload user type int troubleshoot

Quick fix checklist

  • Reproduce the error on a minimal input.
  • Check type/format and field mapping.
  • Apply the smallest safe fix.
  • Validate on production-like payload.

Related by winning cluster

Linked from a winner family to push crawl and first-impression conversion.

Open cluster hubneighbor csharp php json decode arg1 string int given workflows data importneighbor csharp php json decode arg1 string array given workflows data importneighbor csharp php json decode arg1 string float given workflows data importneighbor csharp php json decode expects string array given workflows data importneighbor csharp php json decode expects string array given workflows enterprise rolloutneighbor csharp php json decode expects string null given workflows data importphp json decode arg1 string array givenneighbor go go json cannot unmarshal string into field meta count type int checklists api gateway