Docker容器中Supervisor传递PHP任务环境变量失败问题求助

我之前也踩过类似的坑，咱们一步步来搞定这个问题：

1. 把环境变量配置移到对应任务的[program]段（最推荐） #

你之前把environment配置放在[supervisord]全局段，这其实是给Supervisord自身设置环境变量的，并不是传递给子任务的正确方式。正确的做法是在每个PHP任务的专属[program:xxx]配置块里添加环境变量：

[program:your-php-task]
command=php /path/to/your/php/script.php
; 直接引用系统已存在的环境变量
environment=APP_ENV="%(ENV_APP_ENV)s",APP_DEBUG="%(ENV_APP_DEBUG)s"
; 按需添加其他基础配置
autostart=true
autorestart=true
stdout_logfile=/var/log/supervisor/php-task.log

这样配置后，Supervisord启动PHP任务时，会自动把这些变量注入到子进程的环境中。

2. 确保Supervisord自身能拿到目标环境变量 #

如果上面的配置还是报错，大概率是Supervisord进程本身没继承到APP_ENV和APP_DEBUG这两个变量——这在Docker环境里很常见：

• 如果你用exec模式启动Supervisord（比如Dockerfile里写CMD ["supervisord", "-c", "/etc/supervisor.conf"]），这种方式不会加载shell的环境变量（比如.bashrc、/etc/profile里的配置）；
• 你的环境变量是通过docker run -e传递的，但Supervisord没正确继承。

解决方法：改用shell模式启动Supervisord，让shell先加载所有环境变量，再启动Supervisord。比如修改Dockerfile的CMD：

CMD ["sh", "-c", "supervisord -c /etc/supervisor/supervisord.conf"]

或者写一个启动脚本确保环境变量加载：

#!/bin/sh
# 加载系统全局环境变量（如果你的变量在profile里）
source /etc/profile
# 启动Supervisord并继承当前环境变量
exec supervisord -c /etc/supervisor/supervisord.conf

3. 简化格式字符串（去掉多余引号） #

有时候引号会干扰Supervisord的变量解析逻辑，你可以试试去掉引号，直接写：

environment=APP_ENV=%(ENV_APP_ENV)s,APP_DEBUG=%(ENV_APP_DEBUG)s

Supervisord会自动处理变量值中的空格等特殊情况（如果有的话）。

验证方法 #

你可以先在容器里手动执行printenv | grep APP_，确认APP_ENV和APP_DEBUG确实存在。启动Supervisord后，找到PHP任务的PID，再执行cat /proc/<PID>/environ | tr '\0' '\n' | grep APP_，就能看到变量是否成功传递给了PHP进程。

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