Docker中Apache自定义500错误页面无法显示问题求助

问题现象 #

使用php:7.4-apache镜像构建Docker容器，配置了自定义500错误页面，但触发PHP致命错误（如调用不存在的函数）时，浏览器显示默认错误页面，Apache日志无相关记录，尝试try/catch也无法解决。

现有配置 #

Dockerfile #

FROM php:7.4-apache
COPY . /var/www/html/
COPY php.ini /usr/local/etc/php/
RUN echo "ServerName localhost" >> /etc/apache2/apache2.conf \
    && echo "<Directory /var/www/html/>" >> /etc/apache2/apache2.conf \
    && echo "    AllowOverride All" >> /etc/apache2/apache2.conf \
    && echo "    Require all granted" >> /etc/apache2/apache2.conf \
    && echo "</Directory>" >> /etc/apache2/apache2.conf

RUN a2enmod rewrite

EXPOSE 80

CMD ["apache2-foreground"]

.htaccess #

ErrorDocument 500 /error.html

测试PHP页面（index.php） #

<?php
nonExistentFunction();
?>

自定义错误页面（error.html） #

<html>
<head>
    <title>Error Page</title>
</head>
<body>
    <h1>Unexpected Error</h1>
</body>
</html>

运行命令 #

docker run --rm -p8080:80 myimage

解决方案 #

1. 修改PHP错误配置 #

编辑php.ini，添加或修改以下参数：

display_errors = Off
log_errors = On
error_reporting = E_ALL
html_errors = Off

核心原因：当display_errors开启时，PHP会直接将致命错误输出到浏览器，Apache不会返回500 HTTP状态码，因此无法触发自定义错误页面。关闭该选项后，Apache会接管错误状态，返回500并加载自定义页面。

2. 验证配置生效 #

• 进入容器检查PHP配置：

  docker exec -it <容器ID> php -i | grep -E "display_errors|error_reporting"
  

  确认display_errors显示为Off。

• 查看Apache错误日志，确认错误被记录：

  docker exec -it <容器ID> tail -f /var/log/apache2/error.log
  

  触发错误后，日志中应出现PHP致命错误的详细记录。

3. 可选：直接在Apache配置中添加ErrorDocument #

如果.htaccess仍不生效，可以跳过.htaccess，直接在Dockerfile的Apache配置中添加规则：

RUN echo "ErrorDocument 500 /error.html" >> /etc/apache2/apache2.conf

这样无需依赖.htaccess的AllowOverride设置，配置更直接。

验证结果 #

重启容器后，访问测试页面，浏览器将显示自定义的error.html内容，同时Apache错误日志会正常记录PHP致命错误信息。

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