Unexpected character ('Z' (code 90)): expected a hex-digit for character escape sequence
This message comes from Jackson ObjectMapper on Java 21.0.12. In this registry it is produced by 1 distinct mistake. Positions in the real message vary with your input; the causes do not.
Causes
What produces this message
Malformed \u escape in a JSON string
Input
{"a": "\uZZZZ"}Exact message: Unexpected character ('Z' (code 90)): expected a hex-digit for character escape sequence
Fix: Supply four hex digits, or escape the backslash if you meant a literal `\u`.
Same bug, other languages
What other parsers say about the same input
If a colleague reports a different message for what looks like the same file, this is why.
| Parser | Message for the same inputs |
|---|---|
| CPython json.loads | Invalid \uXXXX escape: line L column C (char N) |
| Gson | \uZZZZ |
| Gson JsonParser (lenient off) | java.lang.NumberFormatException: \uZZZZ |
| JSON5 | JSON5: invalid character 'Z' at 1:10 |
| JSON::PP | unexpected end of string while parsing JSON string, at character offset N (before "…") |
| JavaScriptCore JSON.parse | JSON Parse error: "\uZZZZ" is not a valid unicode escape |
| Newtonsoft.Json JsonConvert | Invalid Unicode escape sequence: \uZZZZ. Path 'a', line L, position N. |
| Newtonsoft.Json JsonTextReader | Invalid Unicode escape sequence: \uZZZZ. Path 'a', line L, position N. |
| Ruby JSON.parse | unexpected token at '…' |
| SpiderMonkey JSON.parse | JSON.parse: bad Unicode escape at line L column C of the JSON data |
| System.Text.Json Deserialize | 'Z' is not a hex digit following '\u' within a JSON string. The string should be correctly escaped. Path: $ | LineNumber: L | BytePositionInLine: C. |
| System.Text.Json JsonDocument | 'Z' is not a hex digit following '\u' within a JSON string. The string should be correctly escaped. LineNumber: L | BytePositionInLine: C. |
| V8 JSON.parse | Bad Unicode escape in JSON at position N (line L column C) |
| encoding/json Unmarshal | invalid character 'Z' in \u hexadecimal character escape |
| hjson | Bad \u char Z at line L,9 |
| json_decode | Syntax error |
| orjson | invalid escaped sequence in string: line L column C (char N) |
| serde_json::from_str | invalid escape at line L column C |
| ujson | Unexpected character in unicode escape sequence when decoding 'string' |
Sources
Standards this registry is checked against
- RFC 8259 (STD 90) — The JavaScript Object Notation (JSON) Data Interchange Format, T. Bray, Ed., 2017. The IETF Internet Standard for JSON. Obsoletes RFC 7159 and RFC 4627.
- ECMA-404, 2nd edition — The JSON Data Interchange Syntax, Ecma International, 2017. Ecma’s grammar for JSON. A normative reference of RFC 8259; the two define the same syntax.
- The Unicode Standard — The Unicode Standard, Core Specification, The Unicode Consortium, current. Normatively referenced by RFC 8259 for the definition of a character.
- IEEE 754-2019 — IEEE Standard for Floating-Point Arithmetic, IEEE, 2019. Referenced by RFC 8259 §6 as the basis for its interoperability guidance on numbers.
Only standards bodies and peer-reviewed venues are cited. Error strings on this site are observed by executing each parser; the standards above define what the parser is reacting to.