Symfony 6.4环境变量配置核心是.env文件，需正确设置APP_ENV、按序加载Dotenv、遵循Shell语法规则；DATABASE_URL须以指定协议开头、用127.0.0.1、显式声明serverVersion、URL编码特殊字符、加charset=utf8mb4并用双引号包裹。
Symfony 6.4 的环境变量配置核心是 .env 文件，它不是普通文本，而是被 Shell 解析的脚本。配置是否生效，不取决于文件名后缀，而取决于 APP_ENV 是否正确设置、Dotenv 是否按序加载、以及变量值是否符合 Shell 语法规则。
必须写对的 DATABASE_URL 格式
数据库连接失败，90% 出在 DATABASE_URL 字符串上。它必须满足以下全部条件：
- 以
mysql://、pgsql://或sqlite://开头，协议不能省略 - 主机地址用
127.0.0.1，不用localhost（避免 Unix socket 连接异常） - 显式声明
?serverVersion=8.0（MySQL 8）、?serverVersion=15（PostgreSQL 15）等 - 密码含
@、/、:等字符时，必须 URL 编码（如pass@word→pass%40word） - 推荐加上
&charset=utf8mb4，支持 emoji 和四字节中文 - 整行值必须用双引号包裹，防止空格或特殊字符被截断
✅ 正确示例：
DATABASE_URL="mysql://root:my%40pass@127.0.0.1:3306/myapp?serverVersion=8.0&charset=utf8mb4"
加载顺序决定谁覆盖谁
Symfony 不会自动识别 .env.dev 或 .env.prod，而是严格按固定顺序加载并覆盖：
-
.env—— 基础默认值（提交到 Git） -
.env.local—— 本地开发覆盖（加到.gitignore） -
.env.$APP_ENV—— 如.env.prod（需APP_ENV=prod已设好） -
.env.$APP_ENV.local—— 如.env.prod.local（生产敏感值唯一存放处）
⚠️ 注意：.env.prod.local 不会自动加载，除非 Web 服务器或系统级已设 APP_ENV=prod；否则 loadEnv() 根本不会去找它。
敏感值必须用 %env(resolve:VAR)% 语法
在 config/packages/doctrine.yaml 或其他配置中引用环境变量时，裸写 %env(DATABASE_URL)% 是无效的——它只是字符串字面量，不会解析。
- ✅ 必须写成：
database_url: '%env(resolve:DATABASE_URL)%' - ✅ 支持类型转换：
debug: '%env(bool:APP_DEBUG)%' - ✅ 支持命令展开：
VERSION: '%env(resolve:$(git rev-parse --short HEAD))%'
不加 resolve:，变量永远不展开；加了但没配 dotenv:dump，生产环境每次请求都重新解析，影响性能。
验证是否真正生效的三个命令
别猜，用命令确认：
-
php bin/console debug:dotenv—— 查看哪些 .env 文件被读取、变量是否解析成功 -
php bin/console debug:config doctrine --env=prod—— 看 Doctrine 配置是否已应用 prod 层覆盖 -
php bin/console debug:container --env-var=DATABASE_URL—— 直接输出最终生效的数据库连接串
如果这三个命令结果一致且符合预期，说明环境变量链路完全打通。
