Apache/PHP Docker环境下API数据传输限制问题求助

我之前处理过好几个类似容器环境下的问题，你的情况大概率是Apache或者PHP的配置限制了POST请求体的大小，尤其是针对JSON这类通过raw请求体传递的数据，下面一步步帮你排查解决：

1. 优先检查Apache的LimitRequestBody配置 #

这是最可能的诱因！部分Apache镜像会默认把这个值设为16KB（16384字节），一旦请求体超过这个大小，就会被直接截断，导致PHP完全读取不到数据。

Docker环境修改方法： #

• 如果用自定义Dockerfile，直接添加：

  RUN echo "LimitRequestBody 0" >> /etc/apache2/apache2.conf
  

  （0表示不限制大小，你也可以设置具体值，比如10485760对应10MB）
• 临时测试的话，进入容器修改后重启Apache：

  docker exec -it your-container-name bash
  echo "LimitRequestBody 0" >> /etc/apache2/apache2.conf
  service apache2 restart
  

2. 检查PHP的POST数据限制 #

虽然PHP默认的post_max_size是8M，但不排除镜像被修改过，导致限制过小：

修改php.ini配置（Docker环境）： #

在Dockerfile里添加以下命令：

# 将post_max_size改为10M
RUN sed -i 's/post_max_size = .*/post_max_size = 10M/' /usr/local/etc/php/php.ini-production
# 同步修改upload_max_filesize（和JSON无关，但建议统一设置避免其他问题）
RUN sed -i 's/upload_max_filesize = .*/upload_max_filesize = 10M/' /usr/local/etc/php/php.ini-production
# 启用修改后的配置文件
RUN cp /usr/local/etc/php/php.ini-production /usr/local/etc/php/php.ini

也可以直接挂载自定义的php.ini到容器的/usr/local/etc/php/php.ini路径。

3. 确保你的PHP脚本正确读取JSON数据 #

很多人会误用$_POST来接收JSON数据，这是错误的！$_POST只针对application/x-www-form-urlencoded或multipart/form-data格式的请求，JSON需要读取原始请求体：

<?php
// 读取原始请求体内容
$rawInput = file_get_contents('php://input');
// 解析为关联数组
$jsonData = json_decode($rawInput, true);

// 调试用：输出原始数据和解析结果
var_dump($rawInput);
var_dump($jsonData);

// 若解析失败，记录错误信息
if (json_last_error() !== JSON_ERROR_NONE) {
    error_log('JSON解析错误: ' . json_last_error_msg());
}
?>

4. 验证测试 #

用curl发送一个超过16KB的JSON数据，确认配置是否生效：

# 生成20KB的测试JSON
echo '{"content": "'$(printf 'a%.0s' {1..20000})'"}' > test.json
# 发送请求到你的PHP脚本
curl -X POST -H "Content-Type: application/json" --data @test.json http://your-container-ip/test.php

如果返回的$rawInput不为空，说明配置修改成功了。

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