Google App Engine中PHP-FPM容器无法访问问题求助

我来帮你排查下这个部署问题，核心原因主要是端口配置错误和PHP-FPM本身不处理HTTP请求导致健康检查失败，以及服务无法被外部访问。下面是分步的解决方案：

1. 修复端口监听的核心问题 #

你的Dockerfile里用了sed -i 's/9000/${PORT}/' /usr/local/etc/php-fpm.d/zz-docker.conf，但这个替换是在镜像构建阶段执行的——此时App Engine的${PORT}环境变量还不存在（它是在容器运行时才注入的），所以替换完全没生效，php-fpm依然默认监听9000端口，而App Engine期望服务监听它指定的PORT端口，这直接导致健康检查连不上、服务超时。

修正方案：把端口替换移到启动脚本 #

创建一个start-fpm.sh启动脚本，在运行时动态替换端口：

#!/bin/sh
# 运行时替换php-fpm监听端口为App Engine指定的PORT
sed -i "s/9000/${PORT}/" /usr/local/etc/php-fpm.d/zz-docker.conf
# 前台运行php-fpm，保证容器存活
exec php-fpm

然后更新Dockerfile，替换原有的CMD逻辑：

FROM php:7.4-fpm-alpine3.11
COPY .docker/php.ini /usr/local/etc/php/conf.d/php.ini
RUN apk --update --no-cache add git
RUN docker-php-ext-install pdo_mysql
COPY --from=composer /usr/bin/composer /usr/bin/composer
WORKDIR /var/www
COPY app /var/www
RUN mkdir http-cache && chown www-data:www-data http-cache/
RUN composer update && composer dump-autoload --no-interaction
# 添加启动脚本并赋予执行权限
COPY start-fpm.sh /usr/local/bin/start-fpm
RUN chmod +x /usr/local/bin/start-fpm
# 使用启动脚本替代直接执行php-fpm
CMD ["start-fpm"]
EXPOSE ${PORT}

2. 解决健康检查失败的问题 #

App Engine Flex默认会向服务的/路径发送HTTP GET请求做健康检查，但PHP-FPM只处理FastCGI请求，不懂HTTP协议——哪怕端口对了，健康检查也会因为无法解析HTTP请求而失败。这里有两种可行的解决思路：

思路A：把Nginx和PHP-FPM打包进同一个镜像（推荐） #

这是生产环境的常规做法：用Nginx处理HTTP请求、健康检查，再把动态请求转发给PHP-FPM。这样App Engine的健康检查可以直接访问Nginx的HTTP端口，外部也能正常访问Symfony服务。

示例合并后的Dockerfile：

# 先构建Nginx配置阶段
FROM nginx:alpine AS nginx-stage
COPY .docker/nginx.conf /etc/nginx/nginx.conf
COPY .docker/default.conf.template /etc/nginx/templates/default.conf.template

# 主镜像构建
FROM php:7.4-fpm-alpine3.11
# 复制Nginx配置
COPY --from=nginx-stage /etc/nginx /etc/nginx
COPY .docker/php.ini /usr/local/etc/php/conf.d/php.ini
# 安装Nginx依赖
RUN apk --update --no-cache add git nginx
RUN docker-php-ext-install pdo_mysql
COPY --from=composer /usr/bin/composer /usr/bin/composer
WORKDIR /var/www
COPY app /var/www
RUN mkdir http-cache && chown www-data:www-data http-cache/
RUN composer update && composer dump-autoload --no-interaction
# 添加启动脚本
COPY start.sh /usr/local/bin/start
RUN chmod +x /usr/local/bin/start
CMD ["start"]
EXPOSE ${PORT}

启动脚本start.sh（同时启动Nginx和PHP-FPM）：

#!/bin/sh
# 替换Nginx配置中的端口为App Engine指定的PORT
sed -i "s/80/${PORT}/" /etc/nginx/templates/default.conf.template
# 后台启动PHP-FPM
php-fpm &
# 前台启动Nginx（保持容器存活）
nginx -g 'daemon off;'

Nginx配置模板default.conf.template（包含健康检查端点）：

server {
    listen ${PORT};
    root /var/www/public;

    # 处理Symfony路由
    location / {
        try_files $uri /index.php$is_args$args;
    }

    # 转发动态请求给PHP-FPM
    location ~ ^/index\.php(/|$) {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_split_path_info ^(.+\.php)(/.*)$;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        fastcgi_param DOCUMENT_ROOT $realpath_root;
        internal;
    }

    # 健康检查端点，供App Engine调用
    location /healthz {
        access_log off;
        return 200 "OK\n";
        add_header Content-Type text/plain;
    }
}

最后在app.yaml里配置健康检查指向这个端点：

runtime: custom
env: flex
health_check:
  enable_health_check: True
  check_interval_sec: 5
  timeout_sec: 4
  unhealthy_threshold: 2
  healthy_threshold: 2
  request_path: /healthz

思路B：将健康检查改为TCP端口检查（仅适合内部服务） #

如果你坚持只部署PHP-FPM镜像，可以把健康检查改成TCP端口检查——只要PHP-FPM在监听PORT端口，健康检查就会通过：

runtime: custom
env: flex
health_check:
  enable_health_check: True
  check_interval_sec: 5
  timeout_sec: 4
  unhealthy_threshold: 2
  healthy_threshold: 2
  type: TCP

注意：这种方式下外部依然无法直接访问PHP-FPM（因为它不处理HTTP），只能用于内部FastCGI代理场景，不适合对外提供Web服务。

3. 验证部署流程 #

修改完成后，重新构建并推送镜像：

docker build -t eu.gcr.io/digital-index-ws1920/php-fpm-prod:0.16 .
docker push eu.gcr.io/digital-index-ws1920/php-fpm-prod:0.16

再部署到App Engine：

gcloud app deploy --image-url eu.gcr.io/digital-index-ws1920/php-fpm-prod:0.16

额外排查技巧 #

• 查看App Engine实时日志：gcloud app logs tail -s default，可以看到健康检查失败的具体原因、服务启动的日志，确认端口是否正确监听。
• 在启动脚本里添加echo "Listening on port ${PORT}"，方便调试环境变量是否被正确注入。

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