Docker中通过supervisord运行httpd与php-fpm失败问题排查

尝试在Docker容器中通过supervisord同时运行httpd和php-fpm，相关配置如下：

supervisord.conf 配置 #

[supervisord]
nodaemon=true


[program:httpd]
command=httpd -DFOREGROUND
stdout_logfile=/dev/stdout
stdout_logfile_maxbytes=0
stderr_logfile=/dev/stderr
stderr_logfile_maxbytes=0

[program:php-fpm]
command=php-fpm -F
stdout_logfile=/dev/stdout
stdout_logfile_maxbytes=0
stderr_logfile=/dev/stderr
stderr_logfile_maxbytes=0

Dockerfile 配置 #

ENTRYPOINT ["supervisord", "-c", "/etc/supervisord.conf"]

使用docker-compose up -d启动应用后，php-fpm能正常运行，但httpd反复启动失败，报错信息显示httpd (pid 11) already running，多次重试后进入FATAL状态。移除supervisord.conf中的php-fpm配置后，httpd可正常启动，且问题呈间歇性出现（约1/10概率成功）。

已知Docker建议单容器单进程，但当前场景需二者共存。尝试过调整supervisord的优先级、关闭autorestart、设置预期错误码等配置，均无效果。已确认httpd和php-fpm均采用前台运行参数，寻求原因排查方向。

• 清理httpd的pid文件残留：httpd默认会生成pid文件（通常在/run/httpd/httpd.pid或类似路径），容器重启或残留的pid文件会导致httpd误判进程已存在。修改httpd的启动命令，先清理pid文件再启动：

  command=rm -f /run/httpd/httpd.pid && httpd -DFOREGROUND
  

• 检查supervisord是否重复触发httpd启动：临时将supervisord的日志输出到文件（修改[supervisord]段添加logfile=/var/log/supervisord.log），查看日志中是否存在多次启动httpd的记录，排除配置重复或启动逻辑异常。
• 核实httpd配置是否强制后台运行：检查httpd主配置文件（如httpd.conf），确认没有Daemon on这类强制后台的配置项，同时排查Listen端口是否存在冲突（比如php-fpm是否占用了httpd的端口）。
• 验证容器内进程真实性：出现报错时，进入容器执行ps aux查看实际进程列表，确认是否真的有httpd进程在运行，还是pid文件残留导致的误报。
• 调整进程启动间隔与参数：给httpd配置添加startsecs=5，确保进程启动稳定后再进行状态检查；同时设置startretries=3，避免快速进入FATAL状态，方便观察启动过程。
• 隔离日志输出：两个进程共享/dev/stdout和/dev/stderr可能导致日志混乱，甚至影响进程启动判断。临时将httpd的日志改为单独文件：

  stdout_logfile=/var/log/httpd/stdout.log
  stderr_logfile=/var/log/httpd/stderr.log
  

  测试是否能解决启动问题，排除日志共享的干扰。

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