部署含POST表单的PHP项目至Google Cloud Run遇CSV下载异常

问题分析 #

本地测试时，通过POST表单触发csv_download.php能正常下载名为test.csv的文件，但部署到Google Cloud Run后，下载的文件名变成了csv_download.php，且文件内容正确。单独部署csv_download.php时功能正常，说明问题出在Apache/PHP的容器配置上，而非业务代码本身。大概率是PHP输出缓冲或Apache头信息处理的配置差异导致Content-Disposition头未被正确识别。

解决方案 #

1. 修正PHP输出缓冲配置 #

Dockerfile中使用了php.ini-development，该配置默认开启output_buffering，可能导致HTTP头信息延迟发送，被Cloud Run或浏览器拦截。建议切换到生产环境配置，或手动关闭输出缓冲：

替换Dockerfile中替换php.ini的行：

# 使用生产环境配置替代开发环境配置
RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"

若需保留开发配置，可添加修改输出缓冲的命令：

RUN sed -i 's/output_buffering = 4096/output_buffering = Off/' "$PHP_INI_DIR/php.ini"

2. 启用Apache headers模块 #

确保Apache能正确传递PHP发送的HTTP头信息，在Dockerfile中添加启用mod_headers的命令：

RUN a2enmod headers

3. 修正CSV下载的头信息写法 #

csv_download.php中使用了HTML实体转义的引号（"），可能导致头信息解析异常，直接使用双引号更稳妥：

<?php
header('Content-Type: text/csv');
// 直接使用双引号，避免实体转义
header('Content-Disposition: attachment; filename="test.csv"');

$fp = fopen('php://output', 'wb');
// CSV处理逻辑
fclose($fp);
?>

4. 完整修改后的Dockerfile示例 #

FROM php:8.0-apache

RUN docker-php-ext-install -j "$(nproc)" opcache
# 启用headers模块以正确传递HTTP头
RUN a2enmod headers

RUN set -ex; \
    { \
    echo "; Cloud Run enforces memory & timeouts"; \
    echo "memory_limit = -1"; \
    echo "max_execution_time = 0"; \
    echo "; File upload at Cloud Run network limit"; \
    echo "upload_max_filesize = 32M"; \
    echo "post_max_size = 32M"; \
    echo "; Configure Opcache for Containers"; \
    echo "opcache.enable = On"; \
    echo "opcache.validate_timestamps = Off"; \
    echo "; Configure Opcache Memory (Application-specific)"; \
    echo "opcache.memory_consumption = 32"; \
    } > "$PHP_INI_DIR/conf.d/cloud-run.ini"

WORKDIR /var/www/html
COPY . ./

RUN sed -i 's/80/${PORT}/g' /etc/apache2/sites-available/000-default.conf /etc/apache2/ports.conf
# 替换为生产环境php.ini
RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"

验证步骤 #

1. 重新构建Docker镜像并部署到Cloud Run
2. 访问index.php，点击下载按钮，检查文件名是否为test.csv
3. 若仍有问题，可在csv_download.php开头添加缓冲清理命令：

<?php
ob_clean();
flush();
header('Content-Type: text/csv');
header('Content-Disposition: attachment; filename="test.csv"');
// 后续代码
?>

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