Symfony 4 Docker容器中APP_ENV环境变量未定义问题排查

你已经做了不少基础配置，但还是遇到了环境变量不生效的问题，我来帮你梳理几个容易遗漏的关键点：

1. 确认环境变量在PHP层面是否真的生效 #

你提到用SET命令验证了容器内的APP_ENV，但要注意：

• 首先确保你进入的是Symfony应用容器，而不是Apache代理容器，别查错了对象
• 其次，有些容器的shell可能不支持SET，换用echo $APP_ENV或者直接查看PHP能读取到的变量更准确：php -r "echo getenv('APP_ENV');"，毕竟Symfony是通过PHP来读取环境变量的，这个结果才是最关键的

2. 检查Apache反向代理的环境变量传递配置 #

如果你的Symfony容器用PHP-FPM运行，Apache默认不会把环境变量传递给后端的FastCGI进程。你需要在Apache的配置里添加如下设置，确保变量能正确传递：

<IfModule mod_proxy_fcgi.c>
    ProxyPassMatch ^/(.*\.php(/.*)?)$ fcgi://symfony-container:9000/var/www/html/$1
    # 强制传递APP_ENV到后端PHP-FPM
    SetEnv APP_ENV prod
    # 其他需要传递的环境变量也可以用SetEnv添加
</IfModule>

当然更稳妥的方式是直接在Symfony容器内部确保环境变量生效，而不是依赖Apache传递。

3. 检查Docker环境变量的设置方式 #

你是怎么给Symfony容器设置APP_ENV的？如果用docker-compose.yml，要确认变量是定义在Symfony服务的environment字段下：

services:
  symfony:
    build: ./symfony
    environment:
      - APP_ENV=prod
    # 其他容器配置...

如果是用docker run命令启动，要确保-e APP_ENV=prod参数是加在Symfony容器的启动命令里，而不是Apache容器。

另外，像Alpine这类轻量基础镜像确实没有/etc/environment文件，你可以用这两种方式替代：

• 在Dockerfile里用ENV APP_ENV prod，这样变量会被持久化到镜像中，容器启动时自动生效
• 如果是临时启动容器，可以在启动命令前直接加变量：APP_ENV=prod php-fpm（假设你的容器启动命令是php-fpm）

4. 检查Symfony入口文件的环境变量读取逻辑 #

移除symfony/dotenv后，Symfony完全依赖系统环境变量，你要确认public/index.php里的读取逻辑是正常的，默认的代码应该类似这样：

$env = $_SERVER['APP_ENV'] ?? $_ENV['APP_ENV'] ?? 'dev';

如果这段代码被修改过，可能导致无法正确读取环境变量。同时也要确保config/packages/prod目录下的配置文件是完整的，prod环境的配置不能缺失。

5. 清理缓存并重启容器 #

有时候旧的缓存会残留，即使环境变量已经设置正确。进入Symfony容器执行以下命令清理缓存：

php bin/console cache:clear --env=prod --no-warmup
php bin/console cache:warmup --env=prod

然后重启Symfony容器和Apache容器，确保新的配置完全生效

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