python config_error ai_generated true

pydantic_core._pydantic_core.ValidationError: 1 validation error for Settings database_url Field required [type=missing, input_value={}, input_type=dict]

ID: python/pydantic-settings-env-not-loaded

Also available as: JSON · Markdown · 中文
80%Fix Rate
86%Confidence
0Evidence
2024-09-27First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
2.x active — — —

Root Cause

pydantic-settings reads env vars at instantiation; the variable name case or prefix doesn't match, or .env file isn't loaded.

generic

中文

pydantic-settings 在实例化时读取环境变量；变量名大小写或前缀不匹配，或未加载 .env 文件。

Workarounds

  1. 95% success 
    from pydantic_settings import BaseSettings, SettingsConfigDict
class Settings(BaseSettings):
    model_config = SettingsConfigDict(env_file='.env', case_sensitive=False)
    database_url: str
  2. 90% success 
    export DATABASE_URL=postgres://...
python -c 'import os; print(os.environ.get("DATABASE_URL"))'

Dead Ends

Common approaches that don't work:

  1. 45% fail

    Still requires the var to be present in os.environ at import time.

  2. 60% fail

    Defeats the purpose of env-driven config; secrets end up in source.

  3. 50% fail

    Runs after field resolution; too late for required-field errors.