PaddlePaddle/PaddleOCR
Documented errors, page 2 of 3. Back to PaddlePaddle/PaddleOCR
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| degenerate text crop (zero width/height) | validation | error | paddleocr, ios, onnx, calibration, geometry |
| Response body is missing data. | exception | error | response-format, contract, http, typescript |
| Worker transport client requires a createWorker() factory. | exception | error | worker, config, validation, typescript |
| Invalid OCR version: . Supported values are . | validation | error | ocr, config, version-validation, valueerror, pipeline |
| .model_dir must be null or an asset descriptor object in… | exception | error | paddleocr, config, browser, model-asset, validation |
| No models are available for lang= | validation | error | ocr, language, model-lookup, config, valueerror |
| Unexpected rec output dims | exception | error | paddleocr, onnxruntime, recognition, model-mismatch, tensor-shape, ctc |
| Connection failed | exception | error | network, dns, tls, typescript |
| PaddleOCR source adapter is not configured. | exception | critical | paddleocr, adapter, configuration, lifecycle, browser |
| Batch extractResult item is missing jobId. | exception | error | response-format, batch, contract, typescript |
| [extract_xcresult_attachments] FAIL: `xcrun xcresulttool… | console | error | paddleocr, ios, xcode, xcresulttool, toolchain |
| Input name not found in `dynamic_shapes | validation | error | tensorrt, dynamic-shapes, input-names, config-mismatch |
| OCR result item is missing result.ocrResults. | exception | error | network, timeout, upload, retryable |
| OCR result page is missing prunedResult. | exception | error | network, connection, upload, retryable |
| Invalid pipeline version | validation | error | vl-pipeline, version-validation, config, valueerror |
| fileUrl and filePath are mutually exclusive. | exception | error | file, validation, client-side, path |
| Download from failed. Retry limit reached | exception | error | network, download, pretrained-model, retry |
| Failed to create a 2D canvas context. | exception | error | browser, canvas, image-source, environment, memory |
| Please set inference model dir in Global.inference_model or… | exception | error | paddle, quantization, config, inference-model |
| Timed out after s waiting for job | exception | error | timeout, polling, async-jobs |
| does not exist! | exception | error | dataset, file-not-found, config, label-file |
| Failed to mkdir | exception | error | filesystem, permissions, save, training |
| Job is a job, not a job. | exception | warning | network, timeout, batch, polling, retryable |
| Malformed JSONL result payload | exception | error | python, asyncio, jsonl, parse, api-client |
| text_recognition_model_dir requires… | exception | error | model-selection, configuration, recognition |
| The norm_layer must be str or paddle.nn.layer.LayerNorm… | validation | error | api-usage, cppd, transformer, type-error |
| .model_name must be provided when .model_dir is set. | exception | error | paddleocr, config, yaml, model-asset |
| Unknown model asset " ". | exception | error | model-selection, configuration, versioning |
| Invalid Base64 input | validation | error | python, mcp, base64, validation |
| OCR model selection must define both detection and… | exception | error | model-selection, configuration, validation |
| degree must be number or list with length 2 | exception | error | data-augmentation, abinet, noise, config, misleading-message, exception |
| Malformed document parsing result payload | exception | error | parsing, schema-mismatch, document-parsing |
| Unknown provider | validation | error | python, mcp, cli, provider, validation |
| Unsupported model | validation | error | python, langchain, enum, validation, document-loader |
| OCR worker is not initialized. | exception | error | lifecycle, worker, initialization, usage-error |
| PaddleOCR.js requires an HTTP(S) origin so model assets can… | exception | error | environment, browser, file-protocol, http, cors |
| in inference.yml declares model_name " " but requested… | exception | critical | model-selection, model-files, configuration, mismatch |
| Unknown argument | validation | error | validation, configuration, kwargs |
| Destination already exists | exception | error | api, response-format, batch, job, schema |
| Unsupported result type | exception | error | python, paddleocr, type-error, version-compat |
| Key 'Global' not found in config file. | exception | error | python, config, yaml, paddleslim, auto-compression |
| worker must be a boolean or an options object. | exception | error | worker, configuration, validation, type-error |
| Found a in the saved `added_tokens_decoder`, should be a… | validation | error | recognition, tokenizer, config, version-mismatch |
| The mode.lower() if KLJSLoss should be one of ['kl', 'js'] | exception | error | config, loss, distillation, enum-value |
| Document parsing result page is missing markdown.text. | exception | warning | network, connection, polling, retryable |
| The hidden size ( ) is not a multiple of the number of… | validation | error | config, transformer, attention, donut-swin |
| [DBLoss]: Unrecognized main loss type! | exception | error | config, loss, db, text-detection, enum-value |
| main_loss_type in BalanceLoss() can only be one of | exception | error | config, loss, text-detection, enum-value |
| {parent} | exception | error | filesystem, path, download |
| Unsupported pipeline_name | exception | error | paddleocr, config, pipeline, validation |
| Make sure that the channel dimension of the pixel values… | validation | error | input-validation, preprocessing, donut-swin, channels |
| Asset " " must be an object. | validation | error | config, validation, type-error, model-assets |
| max_size = must be strictly greater than the requested size… | validation | error | resize, unimernet, argument-validation, preprocessing |
| 'size' must be a list or tuple of two numbers, but got | validation | error | config, imgaug, augmentation, validation |
| compare_ocr_json.py requires `pip install shapely` | exception | error | paddleocr, ios, dependency, shapely, ocr-eval |
| : missing 'items' array | validation | error | paddleocr, ios, json, schema, ocr-eval |
| Unsupported language | validation | error | pdf2word, gui, language-config, validation |
| xcresulttool get test-results failed with exit | console | error | paddleocr, ios, xcode, xcresulttool, test-artifacts |
| Asset " " must define url. | validation | error | config, validation, url, model-assets |
| Failed to convert | exception | error | doc2md, wrapper, error-handling |
| Expected positive integer epochs, but got | validation | error | paddle, lr-scheduler, config, type-error |
| Make sure that all the required parameters | validation | error | paddle, generation, logits-processor, missing-argument |
| Service unavailable | exception | warning | availability, retry, http, typescript |
| Unknown augmenter arg | exception | error | config, imgaug, augmentation, typo |
| Model is not supported with qianfan source. Supported… | validation | error | python, mcp, qianfan, provider, model-selection |
| Tried to step times. The specified number of total steps is | exception | error | lr-scheduler, training, config, runtime |
| invalid layer type | exception | error | config, transformer, latex-ocr, validation |
| `decoder_start_token_id` or `bos_token_id` has to be… | exception | error | paddle, generation, config, missing-argument |
| embed_dim must be divisible by num_heads | validation | error | paddle, config, attention, shape-mismatch, constructor-validation |
| Malformed OCR result payload | exception | error | parsing, schema-mismatch, ocr |
| Authentication failed | exception | critical | authentication, http, credentials, typescript |
| Response body is not valid JSON | exception | error | python, asyncio, json, api-client, http |
| Downloading from failed with code ! | exception | error | network, download, http-status, pretrained-model |
| Unsupported model: . Supported models: . | validation | error | python, mcp, model-selection, validation |
| If `eos_token_id` is defined, make sure that `pad_token_id`… | exception | error | paddle, generation, config, token-ids |
| PP-StructureV3 requires PPStructureV3Options. | validation | error | validation, options, model, client-side |
| normalization layer [ ] is not found | exception | error | paddle, text-rectification, config, normalization |
| Bad request | exception | error | http, bad-request, validation, api |
| Model is not an OCR model. | exception | warning | network, connection, batch, retryable |
| {destination} | exception | error | filesystem, directory, download |
| Either file_url or file_path is required. | validation | error | validation, input, client-side |
| OCR pipeline config must define both… | exception | error | paddleocr, config, yaml, pipeline, validation |
| PaddleOCR-VL models require PaddleOCRVLOptions. | validation | error | validation, options, model, client-side |
| If shear is a single number, it must be positive. | exception | error | data-augmentation, abinet, affine, shear, valueerror |
| This attention mask converter is causal. Make sure to pass… | validation | error | attention-mask, decoding, ppformulanet, api-misuse |
| is not supported in MultiLoss yet | exception | error | config, loss, recognition, enum-value |
| Unsupported lang/ocrVersion combination: lang= | exception | error | model-selection, language, versioning, configuration |
| Unsupported OCR model | validation | error | validation, model, client-side |
| box_type can only be one of ['quad', 'poly'] | validation | error | postprocess, detection, config, inference |
| Missing LMDB dataset value | exception | critical | lmdb, dataset, data-integrity, config |
| DilatedReparamBlock requires kernel_size in [5,7,9,11,13]… | exception | error | paddle, db-fpn, reparameterization, config |
| The filter_logits_fn is not supported | exception | error | sampling, generation, latex-ocr, api-misuse |
| The ` ` should be specified for layers, but it is for . | exception | error | paddle, head-mask, export, shape-mismatch |
| is not a valid , please select one of | validation | error | tokenizer, enum, config, nlp |
| File not found | validation | error | python, langchain, file-not-found, path, document-loader |
| Invalid data URL: expected a comma after the MIME type. | validation | error | python, mcp, data-url, base64, validation |
| Unsupported document parsing model | validation | error | validation, model, client-side |
| xcresulttool export attachments failed with exit | console | error | ios, xcodebuild, xcresult, attachments, cli |
| pylatexenc is required for math formula conversion. Install… | exception | error | optional-dependency, doc2md, math, installation |
| Invalid backend for the VL recognition module | validation | error | vl-pipeline, backend, config, valueerror |