PaddlePaddle/PaddleOCR · error · ResultParseError

Malformed document parsing result payload: {e}

Error message

Malformed document parsing result payload: {e}

What it means

ResultParseError raised while converting downloaded JSONL into a DocParsingResult (PP-StructureV3 / document parsing): a KeyError or TypeError hit the expected structure ('result', 'layoutParsingResults', per-item 'markdown', 'markdown.images', 'exports', etc.). The chained exception identifies the exact missing key or wrong type.

Source

Thrown at paddleocr/_api_client/_poller.py:152

                pages.append(
                    DocParsingPage(
                        markdown_text=markdown["text"],
                        markdown_images=markdown.get("images", {}),
                        output_images=item.get("outputImages", {}),
                        pruned_result=item.get("prunedResult"),
                        input_image_url=item.get("inputImage"),
                        exports=item.get("exports", {}),
                        markdown=markdown,
                        raw=item,
                    )
                )
        return DocParsingResult(
            job_id=job_id,
            pages=pages,
            data_info=data_info,
        )
    except (KeyError, TypeError) as e:
        raise ResultParseError(f"Malformed document parsing result payload: {e}") from e

View on GitHub (pinned to 2661c7c0ef)

Solutions

1. Dump the raw JSONL lines and verify each expected key ('result', 'layoutParsingResults', item['markdown']) exists before parsing
2. Match client version to server version; pin the version pair that works
3. Ensure the job was actually a document-parsing job — use the OCR path for OCR jobs
4. If the schema legitimately changed, extend the parser locally or open an issue with the raw payload attached

Example fix

# before
result = parse_doc_parsing_result(job_id, jsonl)  # KeyError('markdown')

# after
for line in jsonl:
    item = line['result']['layoutParsingResults'][0]
    assert 'markdown' in item, f"unexpected schema: {sorted(item)}"
result = parse_doc_parsing_result(job_id, jsonl)

def looks_like_doc_result(jsonl_data) -> bool:
    return bool(jsonl_data) and all(
        isinstance(l, dict) and isinstance(l.get('result'), dict)
        and isinstance(l['result'].get('layoutParsingResults'), list)
        for l in jsonl_data
    )

def is_doc_parsing_payload(obj: object) -> bool:
    if not isinstance(obj, list) or not obj:
        return False
    r = obj[0].get('result') if isinstance(obj[0], dict) else None
    items = r.get('layoutParsingResults') if isinstance(r, dict) else None
    return bool(items) and isinstance(items[0], dict) and 'markdown' in items[0]

try:
    result = parse_doc_parsing_result(job_id, jsonl_data)
except ResultParseError as e:
    logger.error("doc result schema mismatch for %s: %s", job_id, e)
    raise

When it happens

Trigger: parse_doc_parsing_result(job_id, jsonl_data) raises when a line lacks 'result', 'layoutParsingResults' is missing/not a list, an item lacks 'markdown', or markdown/images entries have unexpected types. Happens when the server's document-parsing schema differs from the client's expectations or a plain-OCR result is fed to the document parser.

Common situations: Version skew between client and PaddleOCR server on the PP-StructureV3 result format; calling the doc-parsing parse path on a plain OCR job's output; server returning an error line inside the JSONL; renamed fields (e.g. markdown.images key changes) after a server upgrade.

Understand the failure class

• Parsing and encoding errors: unexpected token, malformed input — why parsers reject input and how to find the real culprit.

Related errors

• Malformed OCR result payload: {e}
• Failed to parse JSONL result payload.
• Unknown or missing job state: {state}
• 'extractProgress' must be an object.
• Response body must be a JSON object.

AI-assisted analysis of PaddlePaddle/PaddleOCR@2661c7c0ef (2026-08-14). Data as JSON: /api/errors/d7379a5136aaeebd. Report an issue: GitHub.