{"record":{"id":"104a2cb06510a693","repo":"BerriAI/litellm","slug":"redis-cluster-nodes-environment-variable-is-not-va","errorCode":null,"errorMessage":"REDIS_CLUSTER_NODES environment variable is not valid JSON. Please ensure it's properly formatted.","messagePattern":"REDIS_CLUSTER_NODES environment variable is not valid JSON\\. Please ensure it's properly formatted\\.","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"litellm/_redis.py","lineNumber":487,"sourceCode":"        and redis_kwargs[\"startup_nodes\"] is not None\n        or \"sentinel_nodes\" in redis_kwargs\n        and redis_kwargs[\"sentinel_nodes\"] is not None\n    ):\n        pass\n    elif \"host\" not in redis_kwargs or redis_kwargs[\"host\"] is None:\n        raise ValueError(\"Either 'host' or 'url' must be specified for redis.\")\n\n    # litellm.print_verbose(f\"redis_kwargs: {redis_kwargs}\")\n    return redis_kwargs\n\n\ndef init_redis_cluster(redis_kwargs) -> redis.RedisCluster:\n    _redis_cluster_nodes_in_env: Final[str | None] = get_secret(\"REDIS_CLUSTER_NODES\")\n    if _redis_cluster_nodes_in_env is not None:\n        try:\n            redis_kwargs[\"startup_nodes\"] = json.loads(_redis_cluster_nodes_in_env)\n        except json.JSONDecodeError:\n            raise ValueError(\n                \"REDIS_CLUSTER_NODES environment variable is not valid JSON. Please ensure it's properly formatted.\"\n            )\n\n    verbose_logger.debug(\"init_redis_cluster: startup nodes are being initialized.\")\n    from redis.cluster import ClusterNode\n\n    args: Final = _get_redis_cluster_kwargs()\n    cluster_kwargs: Final = {}\n    for arg in redis_kwargs:\n        if arg in args:\n            cluster_kwargs[arg] = redis_kwargs[arg]\n\n    new_startup_nodes: Final[list[ClusterNode]] = []\n\n    for item in redis_kwargs[\"startup_nodes\"]:\n        new_startup_nodes.append(ClusterNode(**item))\n\n    cluster_kwargs.pop(\"startup_nodes\", None)","sourceCodeStart":469,"sourceCodeEnd":505,"githubUrl":"https://github.com/BerriAI/litellm/blob/6c2dcb801bf2b75c18f1bb24140e7cf57465cc4d/litellm/_redis.py#L469-L505","documentation":"Error \"REDIS_CLUSTER_NODES environment variable is not valid JSON. Please ensure it's properly formatted.\" thrown in BerriAI/litellm.","triggerScenarios":"Thrown at litellm/_redis.py:487 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Fix REDIS_CLUSTER_NODES to be valid JSON, e.g. '[{\"host\": \"h1\", \"port\": 6379}]'."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"6c2dcb801bf2b75c18f1bb24140e7cf57465cc4d","analyzedAt":"2026-08-15T07:12:03.035Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}