Illegal unquoted character ((CTRL-CHAR, code 10)): has to be escaped using backslash to be included in string value
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
Literal newline inside a JSON string
Input
{"a": "line1
line2"}Exact message: Illegal unquoted character ((CTRL-CHAR, code 10)): has to be escaped using backslash to be included in string value
Fix: Escape it as `\n`. Any correct serialiser does this for you.
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 control character at: line L column C (char N) |
| JSON5 | JSON5: invalid character '\n' at 2:0 |
| JSON::PP | invalid character 0xA encountered while parsing JSON string, at character offset N (before "…") |
| JavaScriptCore JSON.parse | JSON Parse error: Unterminated string |
| Ruby JSON.parse | unexpected token at '…' |
| SpiderMonkey JSON.parse | JSON.parse: bad control character in string literal at line L column C of the JSON data |
| System.Text.Json Deserialize | '0x0A' is invalid within a JSON string. The string should be correctly escaped. Path: $ | LineNumber: L | BytePositionInLine: C. |
| System.Text.Json JsonDocument | '0x0A' is invalid within a JSON string. The string should be correctly escaped. LineNumber: L | BytePositionInLine: C. |
| V8 JSON.parse | Bad control character in string literal in JSON at position N (line L column C) |
| encoding/json Unmarshal | invalid character '\n' in string literal |
| hjson | Bad string containing newline at line L,0 |
| json_decode | Control character error, possibly incorrectly encoded |
| orjson | unexpected control character in string: line L column C (char N) |
| serde_json::from_str | control character (\u0000-\u001F) found while parsing a string at line L column C |
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.