{"record":{"id":"46cd5cb441e337e6","repo":"sgl-project/sglang","slug":"environment-variable-old-name-is-deprecated-ple","errorCode":null,"errorMessage":"Environment variable {old_name} is deprecated. Please use {self.replacement} instead. {self.note}","messagePattern":"Environment variable (.+?) is deprecated\\. Please use (.+?) instead\\. (.+?)","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"python/sglang/srt/environ.py","lineNumber":1616,"sourceCode":"    def __init__(\n        self,\n        replacement: Optional[str] = None,\n        transform: Optional[Callable[[str], str]] = None,\n        note: Optional[str] = None,\n    ):\n        self.replacement = replacement\n        self.transform = transform\n        self.note = note\n\n    def apply(self, old_name: str):\n        if old_name not in os.environ:\n            return\n        message = f\"Environment variable {old_name} is deprecated.\"\n        if self.replacement is not None:\n            message += f\" Please use {self.replacement} instead.\"\n        if self.note is not None:\n            message += f\" {self.note}\"\n        warnings.warn(message)\n        if self.replacement is not None:\n            value = os.environ[old_name]\n            if self.transform is not None:\n                value = self.transform(value)\n            os.environ[self.replacement] = value\n\n\ndef _ms_to_s(value: str) -> str:\n    return str(float(value) / 1000.0)\n\n\ndef _invert_bool(value: str) -> str:\n    return \"0\" if value.lower() in (\"true\", \"1\", \"yes\", \"y\") else \"1\"\n\n\n# The single registry for deprecated environment variables, processed once at\n# import by _handle_deprecated_envs(). Add new deprecations here instead of\n# ad-hoc warnings. For a rename where the old name must keep working through a","sourceCodeStart":1598,"sourceCodeEnd":1634,"githubUrl":"https://github.com/sgl-project/sglang/blob/0132848349585cfe6aae51c4941cbae872505f8a/python/sglang/srt/environ.py#L1598-L1634","documentation":"sglang's startup env-migration found a variable listed in _DEPRECATED_ENVS. It warns, and if a replacement is defined, copies (optionally transformed) the value to the new name. The old variable keeps existing in os.environ but the canonical name is what the code reads.","triggerScenarios":"Setting a deprecated variable registered in _DEPRECATED_ENVS (e.g. an old tuning flag with a renamed successor) at process start, which triggers _handle_deprecated_envs -> apply().","commonSituations":"Cluster scheduler YAML or container env blocks pinned to an older sglang release then upgrading; docs/blog examples using pre-rename flags.","solutions":["Replace the deprecated var with its replacement named in the warning message","If a transform applies, make sure your value is in the new expected format","Remove the old var from orchestration manifests and retest"],"exampleFix":"# before\nexport SGLANG_OLD_FLAG=xyz\n# after\nexport SGLANG_NEW_FLAG=xyz  # name shown in the warning","handlingStrategy":"validation","validationCode":"# before launch, assert no deprecated vars are set:\nfrom sglang.srt.environ import _DEPRECATED_ENVS\nbad = [k for k in os.environ if k in _DEPRECATED_ENVS]\nassert not bad, bad","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Keep env manifests version-controlled and reviewed per release","Remove old flags when adopting replacements, don't keep both"],"tags":["deprecation","environment-variables","migration","startup"],"backgroundTag":"deprecated-env-var","analyzedSha":"0132848349585cfe6aae51c4941cbae872505f8a","analyzedAt":"2026-08-28T05:10:05.995Z","schemaVersion":2},"datasetVersion":"2026-08-28T06:17:29.519Z"}