Åtgärda Extra data genom att känna igen JSON Lines
När en parser accepterar första objektet men misslyckas vid nästa bör du granska behållarformatet innan du ändrar data. Ett enskilt JSON-dokument har ett toppnivåvärde. JSON Lines lagrar ett fullständigt JSON-värde på varje rad. Två giltiga objekt tillsammans är inte nödvändigtvis ett giltigt dokument.
En rapporterad konvertering från JSONL till CSV misslyckades på rad två. I en annan offentlig diskussion skrev ett skript serialiserade objekt direkt efter varandra; rapportören bekräftade att en radbrytning efter varje objekt rättade det avsedda radorienterade resultatet. Rapporterna betyder inte att varje Extra data-fel handlar om JSON Lines.
Välj en läsare som passar filen
Öppna en kopia i en textredigerare och titta på de första posterna. Om varje komplett objekt står på en egen fysisk rad kan det vara JSON Lines. Om ett objekt sträcker sig över flera rader är detta inte rätt läsare. Om objekt sitter ihop utan avgränsare rättar du koden som skriver filen eller använder en parser avsedd för strömmen. Delning vid avslutande klammerparenteser förstör nästlade objekt och citerad text.
För en liten JSON Lines-fil behåller den här JavaScript-hjälpfunktionen radnumret när tolkning misslyckas. Den tillåter en avslutande radbrytning men kastar inte tyst bort tomma poster.
function readJsonLines(text) {
if (text === "") return [];
const lines = text.split(/\r?\n/);
if (lines.at(-1) === "") lines.pop();
return lines.map((line, i) => {
if (!line.trim()) throw new Error(`Blank record on line ${i + 1}`);
try { return JSON.parse(line); }
catch { throw new Error(`Invalid JSON on line ${i + 1}`); }
});
}
const source = '{"id":"001"}\n{"id":"002"}\n';
const records = readJsonLines(source);
console.log(records.length); // 2
const ordinaryJson = JSON.stringify(records, null, 2);
const jsonLines = records.map(item => JSON.stringify(item)).join("\n") + "\n";Välj ordinaryJson när mottagarprogrammet förväntar sig ett dokument med en array. Välj jsonLines när det väntar sig en post per rad. Lägg inte kommatecken mellan de senare posterna. För en tom postmängd skriver du en tom JSON Lines-fil, inte den ensamma radbrytning som det sista exempeluttrycket ger.
Jämför antalet tolkade poster med avsett antal i källan och granska första och sista ID:t. Om en rad misslyckas granskar du den i originalkopian. Att hoppa över den kan få konverteringen att ”bli klar” medan en order eller logghändelse tyst tappas bort. Ett rapporterat radnummer är säkrare än att logga hela posten om den innehåller privat information.
När filen är för stor för att bekvämt rymmas i minnet ersätter du småfilshjälpen med en strömmande radläsare. Behåll samma fel- och postantalskontroller. JSON Lines löser postgränser; det plattar inte automatiskt ut nästlade värden till CSV-kolumner.
Postgränser är en del av formatet
Hjälpfunktionen accepterar radslut LF och CRLF, inte ensamt CR. Filtillägget .json fastställer inte postformatet. Om målet är CSV bestämmer du hur saknade och nästlade fält ska mappas till kolumner och använder sedan en CSV-skrivare som hanterar kommatecken, citattecken och inbäddade radbrytningar.
Vårt Node v24.19.0-testfall använde {"id":"001"} och {"id":"002"} på separata rader. Tolkning av hela indata misslyckades vid andra objektet. Tolkning av de två raderna gav två poster, och JSON.stringify(records) skapade ett giltigt arraydokument. Feltext och position varierar mellan körmiljöer.
Välj utdataformat medvetet
Pythons dokumentation varnar för att upprepade dump-anrop inte skapar ett giltigt enskilt JSON-dokument: JSON är inget protokoll med inramade meddelanden. Ett .json-filnamn räcker inte för att avgöra hur posterna ska vara åtskilda. Bekräfta förväntat format med verktyget som ska läsa filen.
