Hey，我碰到过好多次自定义镜像踩坑的情况，先给你捋捋排查的步骤，一步步来总能找到问题所在：

先抓准启动失败的具体原因 #

“启动失败”太模糊了，先把日志拉出来看，这是最直接的线索：

• 查看PHP-FPM容器的报错细节：docker-compose logs php
• 查看Nginx容器的日志输出：docker-compose logs nginx
• 甚至可以单独运行你的自定义PHP镜像，测试能否正常启动：docker run --rm your-custom-php-image，或者加参数验证PHP-FPM可用性：docker run --rm -it your-custom-php-image php-fpm -v，如果启动就崩溃，这里会直接抛出具体错误。

对比自定义镜像与官方镜像的核心差异 #

官方PHP7.0-FPM镜像（一般基于Debian或Alpine）和你基于Ubuntu18.04的镜像，默认配置差异不小，这几个点最容易出问题：

1. PHP-FPM的监听方式不匹配 #

官方镜像默认用TCP监听9000端口，但有些自定义镜像会改成Unix套接字，这会直接导致Nginx无法连接到PHP服务。

• 检查镜像内PHP-FPM的配置文件（通常在/etc/php/7.0/fpm/pool.d/www.conf）中的listen指令：

  官方默认配置：listen = 9000
  如果你的配置是listen = /run/php/php7.0-fpm.sock，要么在docker-compose中把套接字所在目录挂载给Nginx，要么直接改成TCP监听9000，这种方式更省心。

2. 权限不匹配踩坑 #

Ubuntu18.04里的www-data用户UID/GID和官方镜像可能不一致，会导致PHP进程无权限访问网站目录，或者Nginx无法读取PHP的套接文件。

• 可以在你的Dockerfile中添加一行，把www-data的UID/GID改成和官方Nginx镜像一致（一般是1000）：

  RUN usermod -u 1000 www-data && groupmod -g 1000 www-data
  

• 另外，本地挂载的网站目录权限也要调整，确保www-data能读写：sudo chown -R www-data:www-data ./你的网站目录

3. PHP-FPM启动命令错误 #

官方镜像用的是前台启动命令php-fpm7.0 -F，如果你的自定义镜像启动命令是后台运行（没加-F参数），容器启动后会立刻退出，看起来就是“启动失败”。

• 检查Dockerfile里的CMD或ENTRYPOINT，确保是前台运行的命令，比如：

  CMD ["php-fpm7.0", "-F"]
  

4. 扩展依赖缺失 #

你说已经添加了所需扩展，但有些扩展依赖系统库，没安装的话PHP-FPM启动会崩溃。

• 查看PHP日志里有没有PHP Startup: Unable to load dynamic library这类报错，比如安装gd扩展需要libpng-dev、libjpeg-dev等系统库，装扩展时别忘了把这些依赖装上。

检查Nginx与docker-compose的关联配置 #

1. Nginx的PHP转发地址要对应 #

如果PHP是TCP监听9000端口，Nginx配置里要写：

fastcgi_pass php:9000; # 这里的php是docker-compose中PHP服务的名称，别写错

如果是套接字方式，需要在docker-compose中把套接字目录共享给Nginx：

services:
  php:
    volumes:
      - php-socket:/run/php
  nginx:
    volumes:
      - php-socket:/run/php
      - ./你的网站目录:/var/www/html

然后Nginx配置改成：

fastcgi_pass unix:/run/php/php7.0-fpm.sock;

2. 网站目录挂载要一致 #

确保PHP和Nginx容器挂载的是同一个本地目录，不然Nginx能看到文件，PHP却找不到，也会触发报错。比如docker-compose中：

services:
  php:
    volumes:
      - ./web:/var/www/html
  nginx:
    volumes:
      - ./web:/var/www/html

如果还没解决，提供这些信息进一步排查 #

要是上面的步骤都试了还是不行，你把这些内容贴出来，能更快定位问题：

• 自定义PHP镜像的完整Dockerfile内容
• docker-compose.yml的全部代码
• Nginx的完整配置文件
• docker-compose logs php和docker-compose logs nginx的输出内容

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