Docker WordPress容器返回500服务器错误，求助原因排查

错误信息回顾 #

浏览器端500错误：

Internal Server Error
The server encountered an internal error or misconfiguration and was unable to complete your request.

Please contact the server administrator at webmaster@localhost to inform them of the time this error occurred, and the actions you performed just before this error.

More information about this error may be available in the server error log.

Apache/2.4.57 (Debian) Server at localhost Port 8080

容器终端日志：

wordpress-1  | [Wed Feb 21 19:18:21.258309 2024] [core:alert] [pid 38] [client 192.168.65.1:37509] /var/www/html/.htaccess: </IfModule> without matching <IfModule> section
wordpress-1  | 192.168.65.1 - - [21/Feb/2024:19:18:21 +0000] "GET / HTTP/1.1" 500 801 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36"

核心成因 #

终端日志已明确指出问题根源：/var/www/html/.htaccess文件中存在无匹配起始标签的</IfModule>闭合标签。Apache服务器解析配置文件时要求所有标签必须成对出现，单独的闭合标签会直接导致配置解析失败，触发500内部服务器错误。

具体触发场景 #

• 手动编辑误操作：修改.htaccess时删除了<IfModule>起始行，但保留了对应的</IfModule>闭合行，破坏了标签的成对规则。
• 插件/主题自动修改异常：部分WordPress缓存、SEO类插件会自动修改.htaccess，如果插件写入过程中崩溃或被中断，可能留下不完整的标签结构。
• 外部内容导入遗漏：从其他环境复制.htaccess内容时，只粘贴了闭合标签部分，遗漏了对应的<IfModule>起始标签。

Docker环境下重启无效的原因 #

Docker容器重启仅会重启Apache和WordPress进程，但不会自动修复挂载目录或容器内持久化存储中.htaccess的语法错误——问题根源在文件内容本身，而非进程运行状态，因此重启操作无法解决问题。

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