在GCloud部署Django网站时提示需设置DATABASE_URL环境变量如何解决？

该错误由django-environ依赖包的配置校验逻辑触发：调用env.db()方法时，程序会默认读取运行环境中的DATABASE_URL环境变量解析数据库连接信息，变量不存在就会抛出该异常。

额外注意：你当前贴出的settings.py代码存在语法问题，if判断下的两行配置没有缩进，会触发Python语法错误，需要先修正为如下格式：

# If the flag as been set, configure to use proxy
if os.getenv("USE_CLOUD_SQL_AUTH_PROXY", None):
    DATABASES["default"]["HOST"] = "127.0.0.1"
    DATABASES["default"]["PORT"] = 5432

1. 本地Windows开发环境配置 #

根据你的需求选择临时或永久配置方式：

• 临时生效（仅当前命令行窗口有效）
  打开运行Django项目的命令行工具，执行对应命令：
  • CMD环境：set DATABASE_URL=postgres://数据库用户名:数据库密码@127.0.0.1:5432/数据库名
  • PowerShell环境：$env:DATABASE_URL="postgres://数据库用户名:数据库密码@127.0.0.1:5432/数据库名"
    若使用非PostgreSQL数据库，替换前缀即可：MySQL用mysql://，SQLite用sqlite:///本地SQLite文件路径。
• 永久生效（所有命令行窗口生效）
  右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，新建用户/系统变量，变量名填DATABASE_URL，变量值填上述格式的连接字符串，保存后重启命令行即可。

2. GCloud部署环境配置 #

根据你使用的部署服务对应配置：

• Cloud Run部署：执行部署命令时追加环境变量参数

  gcloud run deploy 你的服务名 --set-env-vars DATABASE_URL="postgres://数据库用户名:数据库密码@//cloudsql/你的GCP项目ID:实例所在区域:CloudSQL实例名/数据库名"
  

• App Engine部署：在app.yaml文件中添加环境变量配置

  env_variables:
    DATABASE_URL: "postgres://数据库用户名:数据库密码@//cloudsql/你的GCP项目ID:实例所在区域:CloudSQL实例名/数据库名"
    USE_CLOUD_SQL_AUTH_PROXY: "true"
  

• 本地使用Cloud SQL Auth Proxy连接云端数据库时，DATABASE_URL格式和本地数据库一致，host填127.0.0.1即可。

可选：添加默认值避免无配置时报错 #

可以给env.db()方法添加default参数，未检测到环境变量时自动 fallback 到默认配置，适合本地开发场景：

DATABASES = {"default": env.db(default="sqlite:///db.sqlite3")}

以上配置未找到DATABASE_URL时会自动使用本地SQLite数据库，无需额外配置环境变量。

内容的提问来源于stack exchange，提问作者keerthi priya