{"record":{"id":"a3a8fdc8b0aed167","repo":"vllm-project/vllm","slug":"please-specify-ec-role-when-ec-connector-is-set-s","errorCode":null,"errorMessage":"Please specify ec_role when ec_connector is set, supported roles are {get_args(ECRole)}","messagePattern":"Please specify ec_role when ec_connector is set, supported roles are (.+?)","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"vllm/config/ec_transfer.py","lineNumber":89,"sourceCode":"        \"\"\"\n        # no factors to consider.\n        # this config will not affect the computation graph.\n        factors: list[Any] = []\n        hash_str = hashlib.md5(str(factors).encode(), usedforsecurity=False).hexdigest()\n        return hash_str\n\n    def __post_init__(self) -> None:\n        if self.engine_id is None:\n            self.engine_id = str(uuid.uuid4())\n\n        if self.ec_role is not None and self.ec_role not in get_args(ECRole):\n            raise ValueError(\n                f\"Unsupported ec_role: {self.ec_role}. \"\n                f\"Supported roles are {get_args(ECRole)}\"\n            )\n\n        if self.ec_connector is not None and self.ec_role is None:\n            raise ValueError(\n                \"Please specify ec_role when ec_connector \"\n                f\"is set, supported roles are {get_args(ECRole)}\"\n            )\n\n    @property\n    def is_ec_transfer_instance(self) -> bool:\n        return self.ec_connector is not None and self.ec_role in get_args(ECRole)\n\n    @property\n    def is_ec_producer(self) -> bool:\n        return self.ec_connector is not None and self.ec_role in get_args(ECProducer)\n\n    @property\n    def is_ec_consumer(self) -> bool:\n        return self.ec_connector is not None and self.ec_role in get_args(ECConsumer)\n\n    @property\n    def is_encode_only(self) -> bool:","sourceCodeStart":71,"sourceCodeEnd":107,"githubUrl":"https://github.com/vllm-project/vllm/blob/c794754062d49a8fdb63ab3c5215b488b865030c/vllm/config/ec_transfer.py#L71-L107","documentation":"Error \"Please specify ec_role when ec_connector is set, supported roles are {get_args(ECRole)}\" thrown in vllm-project/vllm.","triggerScenarios":"Raised at vllm/config/ec_transfer.py:89 when validation fails: Please specify ec_role when ec_connector is 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_transfer.py:89 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":["Specify ec_role alongside ec_connector, using one of the supported roles listed in the error."],"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-15T17:31:12.345Z"}