最近很多朋友在做 Docker 部署的时候碰到一个问题：PHP‑FPM 的错误日志会在 Nginx 的容器里也出现一遍，导致日志文件变得很乱。今天我来讲讲怎么解决这个问题， 保证只在 PHP‑FPM 容器里看到错误信息，Nginx 容器里就不再多余。

为什么会出现重复日志？

先说说根本原因。我们都知道， PHP‑FPM 默认把错误信息写到 stderr，然后 FastCGI 模块会把这些 stderr 捕获并转成 ... FastCGI sent in stderr 的形式写到 Nginx 日志中。 这家伙... 于是同一条错误就会在两个容器里出现一次。

如果你把 php 的 error_log 指向 /dev/stdout， 看起来就像是把所有错误都导向标准输出了可是其实吧仍然会有一部分错误被 PHP‑FPM 写到 stderr， 摆烂... 这样就会被 Nginx 再抓一次。

所以解决办法就是：显式地把 error_log 设置为 /proc/self/fd/2。这样所有错误都会走同一个路径， 功力不足。 只产生一次输出，符合 12-factor log 的原则。

常见误区：/dev/stdout 与 /proc/self/fd/2 的区别

总结一下。 /dev/stdout 是一个符号链接，它指向当前进程的标准输出。但 PHP‑FPM 在内部处理错误时 对 stderr 有特殊逻辑，即使你指定了 /dev/stdout，也可能仍然走默认的 stderr 路径。

/proc/self/fd/2 则直接指向当前进程的文件描述符 2， 这是可以说的吗？ 不会再触发额外的重定向逻辑，所以呢可以确保只输出一次。

配置示例：Dockerfile 与 docker-compose

# Dockerfile 示例

COPY docker-php-error- /usr/local/etc/php//docker-php-error-

# docker-php-error- 内容如下：

; 将所有 PHP 错误强制输出到 stderr
error_log = /proc/self/fd/2
log_errors = On
display_errors = Off

⚠️ 注意事项：

• 在 Docker 环境中将 php 错误重定向到 stdout 时 错误消息会一边出现在 php-fpm 和 nginx 容器日志中，这是因 php-fpm 默认通过 stderr 向 fastcgi 传递错误所致；正确做法是将 `error_log` 指向 `/proc/self/fd/2`，确保日志仅输出一次且符合 12-factor 日志原则。
• 根本原因在于：/dev/stdout 是一个符号链接，而 PHP‑FPM 在内部错误处理路径中对 stderr 有特殊逻辑。若未显式覆盖，部分错误仍会走 stderr 通路。

Nginx 配置不需要改动

蚌埠住了！ Nginx 本身不需要任何额外配置， 只要你让 PHP‑FPM 把日志统一送到 /proc/self/fd/2，就能避免重复。下面给出一个最简化的 nginx.conf 示例：

worker_processes auto;
events { worker_connections 1024; }
http {
    server {
        listen 80;
        server_name example.com;
        location ~ \\.php$ {
            fastcgi_pass   php-fpm:9000;
            fastcgi_index  index.php;
            fastcgi_param SCRIPT_FILE不结盟E $document_root$fastcgi_script_name;
            include fastcgi_params;
        }
    }
}

AWS Lightsail、 Linode、DigitalOcean 等云主机环境同样适用

无论你是在 AWS Lightsail、Linode、DigitalOcean 或者自建裸机上部署，只要使用 Docker + Nginx + PHP‑FPM 就能用上述配置去掉重复日志。主要原因是核心问题始终是 PHP‑FPM 把 error_log 写错位置导致多余抓取。

AWS Lightsail 快速上手步骤

• Create instance → Ubuntu Server → SSH 登录.
• `docker pull php:fpm` && `docker pull nginx`.
• Create `Dockerfile` 与 `docker-compose.yml` 并按前面示例填好.
• `docker-compose up -d` 启动服务.
• `docker logs phpfpm_container | grep 'FastCGI'` 验证是否还有重复.

Docker Compose 示例文件

你猜怎么着？ // docker-compose.yml version: '3' services: nginx: image: nginx:latest volumes: - ./nginx.conf:/etc/nginx/conf.d/default.conf - ./public:/var/www/html depends_on: - phpfpm ports: - "80:80"

phpfpm: build: context: . dockerfile: Dockerfile volumes: - ./public:/var/www/html environment: # 如果想动态注入，可以用 env_file 或 .env 文件。 # 如下： # PHPRC=/etc/php.ini

栓Q了... 注意：上面代码片段后面有点小格式错乱，但这不影响实际运行。

重启服务后施行请求， 你将只在 PHP‑FPM 容器日志中看到：

; 将所有 PHP 错误强制输出到 stderrerror_log = /proc/self/fd/2log_errors = Ondisplay_errors = Off，探探路。

...

当你在 PHP-FPM 容器中设置 error_log = /dev/stdout 时看似已将错误导向标准输出，但实际仍可能触发 PHP-FPM 的默认错误处理机制——它会主动将错误内容写入 stderr， 平心而论... 而该流会被 Nginx 的 FastCGI 模块捕获并封装为 ... FastCGI sent in stderr... 日志。

也是没谁了... ✅ 正确解决方案是将 error_log 显式设为 /proc/self/fd/2： ; 或者 error_log = /proc/self/fd/2

或者在运行时通过 php-config 或环境变量注入。

再说说提醒一句：别忘了每次改完配置后都要重启容器，否则改动不会生效。如果你遇到什么奇怪的问题， 可以先检查一下容器内是否真的只有 one log line 出现，而不是两条互相冲突的信息，提到这个...。

本文仅供技术交流，。如需进一步帮助，请联系专业人士或查阅官方文档。祝你编码愉快！😄🚀🛠️🙌🎉👨‍💻👩‍💻🔧💡🧰🗂️📚📈📊✨🌐🖥️🖱️💬📢🔍🤔🤓👍🏽👏🏽🍀🚨🚧❗️⚠️🛑✋🏼🤝🎁🔗📜🛠️💻⌨️📶📡🎧🎤🎬🎮🐱‍🏍🐱‍🚀🐶🐱🐭🐰🐼🐸🥳✨🌈🚀🔥🌟💎🥇🥈🥉🏆🍕🍔🍟🥗🍜🍣🍩☕☕☕ 🍵☕ 🍶 🍸 🍹 🥃 🥤 🍺 🍻 🎉 🎊 🚁 🚀 🌌 🌠 ✨ 💫 🔭 🚞 🏞️ 🌋 ⛰️ 🏜️ 🌅 🌇 🌆