Symfony正确加载.env.prod.local的前提是APP_ENV=prod已由Web服务器或系统级环境变量预先设置，否则Dotenv不会自动查找该文件；其加载顺序为.env→.env.local→.env.prod→.env.prod.local，且该文件必须置于.gitignore中、无语法错误。
生产环境不能直接读 .env 文件，必须用 dotenv:dump 编译成 .env.local.php；开发环境可以依赖 loadEnv() 自动加载多层文件，但别把敏感值写进 .env 或 .env.dev。
如何让 Symfony 正确加载 .env.prod.local 而不是 .env
默认情况下，loadEnv() 会按顺序加载 .env → .env.local → .env.$APP_ENV → .env.$APP_ENV.local。但在生产环境，你得确保 APP_ENV=prod 已被提前设好（比如在 Web 服务器配置里用 SetEnv 或 export），否则 loadEnv() 根本不会去找 .env.prod* 文件。
常见错误现象：
-
$_ENV['DATABASE_URL']是空的，但.env.prod.local确实存在且格式正确 -
bin/console debug:container --env-var=DATABASE_URL显示未定义
解决方法：
- 检查
APP_ENV是否已通过 Web 服务器或系统级环境变量设置（echo $APP_ENV在 CLI 下验证） - 确认
.env.prod.local在gitignore中，且不包含语法错误（如漏掉引号、未闭合的${}） - 避免在
.env里写敏感值——它可能被提交到 Git，而.env.prod.local才是唯一该存密码的地方
为什么 %env(resolve:DB)% 比直接写 %env(DB)% 更安全
%env(DB)% 只做字符串替换，如果 DB 的值是 mysql://user:pass@host/db?charset=utf8mb4，它原样塞进 DSN 字符串里；而 %env(resolve:DB)% 会先解析变量引用（比如 ${DB_HOST}）、执行默认值回退（${DB_PORT:-3306}）、甚至展开命令输出（$(date +%s)），最后才注入配置。
典型使用场景：
- 数据库 URL 需要动态拼接主机、端口、数据库名时，用
resolve避免硬编码 - API 密钥需要从外部命令读取（如 AWS Secrets Manager CLI 输出），
resolve支持$(aws ...)语法 - 类型转换（如
%env(int:MAX_RETRY)%）必须搭配resolve才生效
注意：resolve 有性能开销，生产环境应配合 dotenv:dump 使用，否则每次请求都重新解析。
配置参数覆盖失效的三个常见原因
Symfony 的参数覆盖（比如 when@prod 块）看起来很直观，但实际常因加载顺序或语法细节失败。
容易踩的坑：
-
when@prod必须写在config/packages/prod/*.yaml里，而不是config/services.yaml—— 后者不支持条件块 - YAML 缩进错误：
when@prod下的parameters:必须缩进对齐，且子项再缩进两格，错一格就整个块被忽略 - 参数名拼写不一致：基础配置写
app.cache_ttl，when@prod里却写app.cache_ttl_seconds，覆盖自然无效
验证方式：运行 bin/console debug:config framework --env=prod | grep cache_ttl，看输出是否为 prod 值。
生产环境禁止用 Dotenv::load() 的真实原因
Dotenv::load() 是纯文本解析，每请求一次就打开、读取、正则匹配、变量替换 —— 这在开发环境无所谓，但在高并发生产环境，I/O 和 CPU 开销会明显拖慢响应。更关键的是，它无法跳过注释行或处理嵌套变量，遇到 # 后带空格的行可能直接报错。
正确做法只有两个：
- 部署时运行
php bin/console dotenv:dump prod，生成.env.local.php（这是优化后的 PHP 数组，直接include） - Web 服务器层面用
SetEnv或env指令预设关键变量（如DATABASE_URL），让 Symfony 跳过 Dotenv 加载流程
最易被忽略的一点：即使你用了 dotenv:dump，如果 .env.local.php 权限设为 644 且和 webroot 同目录，它可能被直接 HTTP 访问——必须确保该文件不在 Web 可访问路径下，或用 Web 服务器规则拒绝对它的请求。
