{"record":{"id":"b2914b6c3adb6543","repo":"infiniflow/ragflow","slug":"instance-instance-name-not-found-for-model-mode","errorCode":null,"errorMessage":"Instance {instance_name} not found for model {model_name}.","messagePattern":"Instance (.+?) not found for model (.+?)\\.","errorType":"exception","errorClass":"LookupError","httpStatus":null,"severity":"error","filePath":"api/db/joint_services/tenant_model_service.py","lineNumber":237,"sourceCode":"    n = len(parts)\n    if n == 3:\n        pure_model_name, instance_name, provider_name = parts\n    elif n == 2:\n        pure_model_name, provider_name = parts\n        instance_name = \"default\"\n    else:\n        pure_model_name = parts[0]\n        provider_name = \"\"\n        instance_name = \"\"\n    return pure_model_name, instance_name, provider_name\n\n\ndef _resolve_instance_for_model(provider_obj, instance_name: str, model_name: str):\n    instance_obj = TenantModelInstanceService.get_by_provider_id_and_instance_name(provider_obj.id, instance_name)\n    if instance_obj:\n        return instance_obj\n    if instance_name != \"default\":\n        raise LookupError(f\"Instance {instance_name} not found for model {model_name}.\")\n\n    active_instances = [inst for inst in TenantModelInstanceService.get_all_by_provider_id(provider_obj.id) if inst.status == ActiveStatusEnum.ACTIVE.value]\n    if len(active_instances) == 1:\n        logger.warning(\n            \"Model instance fallback applied for legacy default instance name\",\n            extra={\n                \"provider_name\": provider_obj.provider_name,\n                \"requested_instance_name\": instance_name,\n                \"resolved_instance_name\": active_instances[0].instance_name,\n                \"model_name\": model_name,\n            },\n        )\n        return active_instances[0]\n\n    raise LookupError(f\"Instance {instance_name} not found for model {model_name}.\")\n\n\ndef resolve_model_config(tenant_id, model_type: str | enum.Enum, model_ref: str):","sourceCodeStart":219,"sourceCodeEnd":255,"githubUrl":"https://github.com/infiniflow/ragflow/blob/554fb1133ac3861732235ad9c377eb5e0a770665/api/db/joint_services/tenant_model_service.py#L219-L255","documentation":"Error \"Instance {instance_name} not found for model {model_name}.\" thrown in infiniflow/ragflow.","triggerScenarios":"Thrown at api/db/joint_services/tenant_model_service.py:237 when the library encounters an invalid state.","commonSituations":"The model configuration references a provider instance that does not exist or was removed; using a valid instance name prevents this error.","solutions":["Verify the provider instance name for the model is correct.","Check the tenant's configured model instances and use an existing one."],"exampleFix":"# look up available instances first, then reference a valid instance_name","handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"554fb1133ac3861732235ad9c377eb5e0a770665","analyzedAt":"2026-08-15T09:20:16.380Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}