{"record":{"id":"1bc4ea81d3cf370b","repo":"vllm-project/vllm","slug":"manager-config-requires-encoder-cache-manager-cls","errorCode":null,"errorMessage":"manager_config requires encoder_cache_manager_cls to be set.","messagePattern":"manager_config requires encoder_cache_manager_cls to be set\\.","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"vllm/config/ec_manager_config.py","lineNumber":22,"sourceCode":"from abc import ABC\nfrom dataclasses import field\nfrom typing import Any\n\nfrom vllm.config.utils import config\nfrom vllm.utils.import_utils import resolve_obj_by_qualname\n\n\n@config\nclass EncoderCacheManagerConfig:\n    encoder_cache_manager_cls: str | None = None\n    \"\"\"Fully qualified class name of the custom encoder cache manager.\"\"\"\n\n    manager_config: dict[str, Any] = field(default_factory=dict)\n    \"\"\"Opaque configuration interpreted by the custom cache manager.\"\"\"\n\n    def __post_init__(self) -> None:\n        if self.encoder_cache_manager_cls is None and self.manager_config:\n            raise ValueError(\n                \"manager_config requires encoder_cache_manager_cls to be set.\"\n            )\n\n    def get_encoder_cache_manager_obj(self):\n        cls_path = self.encoder_cache_manager_cls\n        if cls_path is None:\n            return None\n        return resolve_obj_by_qualname(cls_path)\n\n\nclass EncoderCacheManagerMetadata(ABC):  # noqa: B024\n    \"\"\"\n    Abstract Metadata used to communicate between the\n    Scheduler EncoderCacheManager and Worker EncoderCacheManager.\n    \"\"\"\n\n    pass\n","sourceCodeStart":4,"sourceCodeEnd":40,"githubUrl":"https://github.com/vllm-project/vllm/blob/c794754062d49a8fdb63ab3c5215b488b865030c/vllm/config/ec_manager_config.py#L4-L40","documentation":"Error \"manager_config requires encoder_cache_manager_cls to be set.\" thrown in vllm-project/vllm.","triggerScenarios":"Raised at vllm/config/ec_manager_config.py:22 when validation fails: manager_config requires encoder_cache_manager_cls to be set.. Typically triggered by an incompatible or incomplete vLLM configuration, an unsupported platform/backend combination, or a runtime resource/dependency that is missing.","commonSituations":"Commonly encountered at vllm/config/ec_manager_config.py:22 during vLLM startup/config validation or runtime setup when: (1) conflicting CLI flags or config fields are combined, (2) the current platform (CUDA/ROCm/CPU/XPU) or installed optional packages do not support the requested feature, or (3) a required value is absent or out of range. Resolve by correcting the configuration as described in the message, or by selecting a supported alternative.","solutions":["Set encoder_cache_manager_cls in the manager_config before use."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"c794754062d49a8fdb63ab3c5215b488b865030c","analyzedAt":"2026-08-14T21:17:39.825Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}